Skip to main content
fetchbean runs on prepaid credits. You top up a balance from the dashboard, and calls are charged against it. Fixed-cost calls require enough balance for their full price before they start. Metered calls require enough balance for an upfront estimate, then settle their actual usage.

​
Pricing

Base credit pricing:
  • 1 credit = 0.0001∗∗,sothebaserateis∗∗10,000creditsper0.0001**, so the base rate is **10,000 credits per 1.
  • Each tool has either a fixed credit cost per call or a metered cost based on result count or provider-reported usage.
  • The minimum top-up is 5∗∗.Top−upsof∗∗5**. Top-ups of **50 or more receive 5% bonus credits.
  • Add credits from the Balance section of the dashboard. Payments are processed by Dodo Payments.
Browse per-tool credit costs for every provider and endpoint at fetchbean.com/catalog.

​
Reserve and settle

fetchbean uses a reserve-then-settle model:
1

Reserve

Before a call starts, fetchbean holds the fixed price or the operation’s metered estimate. The call is rejected if the available balance cannot cover that hold. An optional monthly spend cap is also checked against committed usage plus the hold at this point.
2

Execute

fetchbean forwards your request to the upstream provider and waits for a response.
3

Settle

After execution, fetchbean settles the actual charge. Unused credits from the hold are returned. If a metered call costs more than its estimate, the overage is deducted during settlement.
Provider failures and timeouts are billed at zero. A normalization error can be billable when the upstream provider completed successfully, so check the error envelope’s billable field. See Errors.
A metered charge can exceed its upfront estimate, the remaining balance, or the monthly cap after the call has been admitted. The monthly cap controls admission using committed usage and the initial hold; it is not a post-settlement ceiling.

​
Metered tools

Some tools are metered by result count or provider-reported usage rather than charged a flat fee. Each declares an upfront estimate used for admission. The final charge is calculated from actual usage and is not capped by that estimate.

Fixed-cost tools

The listed price is held before execution and charged for a billable result, regardless of response size.

Metered tools

Charged from actual result count or usage. The final charge can be higher or lower than the upfront estimate.