DocumentationBilling

API documentation/v2

Billing

Both endpoints use the same per-request pricing. Each billable request counts once, regardless of how many results it returns.

Billing fields

Every response includes billed, which tells you whether the request counted, and billing_source, which identifies prepaid balance or your monthly Free allowance.

FieldTypeDescription
billedbooleanTrue when the request consumed account usage; false when it did not.
billing_sourcestring | nullWhen billed is true, free means monthly Free allowance was consumed and prepaid means balance was deducted; null when billed is false.

What is billed

Invalid requests, authentication failures and rate-limit rejections are not billed.

Requests use prepaid balance while balance is available and otherwise the monthly Free allowance.

Rates, volume tiers and per-plan rate limits are published on the pricing page.