SEO 一次请求的价格是固定的吗?limit 设很大会怎样?
不是固定价。分页与批量 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 价格页。 - 执行前余额检查:调用前账户余额必须覆盖本次请求的最高可能费用(全部
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。

