> 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/keyword-overview，在 keywords 数组中一次传入同一市场最多 100 个关键词，可同步获取 search_volume、keyword_difficulty、intent 与月度搜索历史。

将同一市场的关键词放入 `keywords` 数组（单次 1–100 个），调用 `POST /v1/seo/keyword-overview` 即可同步返回每个命中词的搜索量、难度、商业指标、搜索意图和月度历史。

## 批量参数与市场规则

* **单次上限与去重**：`keywords` 接收 `1–100` 个字符串，单个词不超过 80 个字符。接口会自动转小写并对重复词去重。
* **单请求单市场**：每次请求指定一组 `country`（两位小写国家码，默认 `us`）与 `language`（默认该市场主语言）；查询其他国家或语言时需分别发送请求。

```bash
curl -sS https://api.beatapi.io/v1/seo/keyword-overview \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["<keyword_1>","<keyword_2>"],"country":"us","language":"en"}'
```

例如调研美国英文站的咖啡机维护专题，可把 `"descale coffee machine"` 和 `"clean coffee grinder"` 放入同一请求并传 `"country": "us"`、`"language": "en"`。

## 记录与解读返回字段

从 `results` 中逐词记录 `search_volume`、`cpc_usd`、`competition`、`keyword_difficulty`、`intent`、`updated_at` 和 `monthly_searches`。搜索量用于评估需求规模，`keyword_difficulty` 按 `0–100` 分值反映竞争难度，`intent` 用于区分操作教程与选购指南。响应省略的字段留空，不自动填零；若只需要难度分，可使用相同入参调用 `POST /v1/seo/keyword-difficulty`。

## 合同与相关问题

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

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