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

# SEO 一次请求的价格是固定的吗？limit 设很大会怎样？

> SEO 接口按单次基础费加 billed_rows 行费结算；调大 limit 会提高执行前的余额校验门槛，实际扣费仍以返回行数计入 usage.price_usd。

不是固定价。分页与批量 SEO 接口采用「单次调用基础费 + `billed_rows` × 单行费」结构。把 `limit` 设得很大时，执行前的余额校验会按最大可能行数检查额度，但最终结算（`usage.price_usd`）只按实际返回行数扣费。

## 基础费、行费与余额预检

* **分组计费标准**：关键词与域名类接口（`keyword-overview`、`keyword-ideas`、`keyword-difficulty`、`domain-overview`、`ranked-keywords`、`top-pages`、`competitors`）为基础费 `$0.018` + 每行 `$0.0003`；外链类接口（`backlink-summary`、`backlinks`）为基础费 `$0.035` + 每行 `$0.0002`。完整价格见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)。
* **执行前余额检查**：调用前账户余额必须覆盖本次请求的最高可能费用（全部 `limit` 行数或全部传入关键词数）。若把 `limit` 设为 `1000`，即使实际只匹配少量记录，余额不足时仍会直接返回 `402 insufficient_credits`。
* **实际扣费核对**：例如设置 `limit: 20` 但返回 `billed_rows: 7` 时，`usage.price_usd` 只按「基础费 + 7 行」结算。

## 空结果与失败请求的计费规则

请求正常执行但无命中记录（`billed_rows: 0` 或 `has_data: false`）时，仍会收取当次基础费。参数校验拦截（`400`）与服务端失败（`503`）不计费。探索字段时先传小 `limit`（如 `10` 或 `20`），确认符合预期后再用 `offset` 翻页。

## 合同与相关问题

发送收费请求前，先免费查看 SEO 合同：`data:seo.keyword_overview`, `data:seo.ranked_keywords`, `data:seo.top_pages`, `data:seo.backlinks`。

[返回SEO问题索引](/zh/faq/seo)。