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

# 怎么查竞品排了哪些关键词？返回的是现在的排名吗？

> 调用 POST /v1/seo/ranked-keywords 传入竞品域名、市场和可选 contains 筛选词，可查看按搜索量排序的快照排名，每行通过 position_seen_at 标明记录时间。

调用 `POST /v1/seo/ranked-keywords` 并传入竞品 `domain` 与目标市场（`country`、`language`），可按搜索量从高到低获取竞品已获得排名的关键词列表。返回的排名属于历史快照而非实时搜索结果，每行 `position_seen_at` 标明排名的观测时间。

## 按主题筛选并控制行数

使用 `contains`（最长 80 个字符、不区分大小写，不支持 `%` 和 `_`）搭配较小的 `limit`（`1–1000`，默认 `100`），可先锁定核心主题，再按需用 `offset` 翻页。

```bash
curl -sS https://api.beatapi.io/v1/seo/ranked-keywords \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"domain":"example.com","country":"us","language":"en","contains":"descale","limit":20}'
```

重点核对每行的 `keyword`、`position`（自然排名）、`absolute_position`（计入全部结果页元素的绝对位置）、`url`、`search_volume`、`search_traffic_estimate` 与 `position_seen_at`。

## 单页分析的范围边界

`POST /v1/seo/ranked-keywords` 始终按整站域名查询：即使在 `domain` 中传入完整页面链接，接口也会自动收敛为域名并去掉前缀 `www.`。分析单个落地页时，需在返回结果中按 `url` 本地过滤，同时记下本次查询范围（`domain`、`contains`、`limit`、`offset`），并在报表里把 `position_seen_at` 放在排名旁边，避免把数周前的快照误当实时排名。

## 合同与相关问题

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

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