ナビゲーションにスキップ

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.018 per call plus $0.0003 per returned row. Backlink endpoints (backlink-summary, backlinks) cost $0.035 per call plus $0.0002 per 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 in keywords). A large limit (such as 1000) can fail with 402 insufficient_credits even when only a few rows exist.
  • Actual settlement: When a limit: 20 query returns billed_rows: 7, usage.price_usd reflects 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.

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.

Back to SEO questions.