Is every SEO call a fixed price? What happens with a large limit?
No. Paginated and batch SEO endpoints charge a per-call base fee plus a per-row fee multiplied by billed_rows. Setting a large limit raises the upfront balance check before the call runs, while final settlement in usage.price_usd bills only the rows actually returned.
Base fee, row fee, and balance check
- Rates by tool group: Keyword and domain endpoints (
keyword-overview,keyword-ideas,keyword-difficulty,domain-overview,ranked-keywords,top-pages,competitors) cost$0.018per call plus$0.0003per returned row. Backlink endpoints (backlink-summary,backlinks) cost$0.035per call plus$0.0002per returned row. See full rates on the BeatAPI pricing page. - Pre-call balance check: Before running, the gateway verifies that account balance covers the worst-case cost (every row in
limit, or every keyword inkeywords). A largelimit(such as1000) can fail with402 insufficient_creditseven when only a few rows exist. - Actual settlement: When a
limit: 20query returnsbilled_rows: 7,usage.price_usdreflects the base call charge plus seven rows.
Empty results and failed calls
An executed query that returns zero rows (or has_data: false) still charges the per-call base fee. Validation refusals (400) and server failures (503) cost nothing. Start with a small limit (for example 10 or 20) to verify returned fields before paginating deeper with offset.
Contracts and related questions
Before sending a paid request, inspect the SEO contracts for free: data:seo.keyword_overview, data:seo.ranked_keywords, data:seo.top_pages, data:seo.backlinks.

