> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Is every SEO call a fixed price? What happens with a large limit?

> SEO endpoints bill a per-call base fee plus a per-row fee on billed_rows; a large limit raises the upfront balance check while final settlement charges only returned rows.

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](https://beatapi.io/pricing).
* **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`.

## 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`.

[Back to SEO questions](/faq/seo).