Research keywords (bulk)
research_keywordsRead-only
Research keyword data (search volume, difficulty, CPC, related ideas) for 1-5 seed keywords in one call. In countries served from Google Ads data, difficulty and intent are unavailable. Returns per-seed results — a single bad seed won't fail the batch.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seeds | Yes | 1-5 seed keywords. Each seed is researched independently and returns related keywords with volume/difficulty/CPC. Bulk-friendly — prefer this over multiple single-seed calls. | |
| projectId | Yes | Required. The HarborRank project ID to scope this call to. Get one from list_projects. | |
| resultLimit | No | Max keywords returned per seed. Defaults to 150. | |
| includeClickstreamData | No | Refine search volumes with clickstream data, which disaggregates Google Ads' grouped close-variant volumes (plurals/misspellings). Use only when plural or misspelling variants need separate volumes. Default false (standard Google-Ads-derived volumes). No effect for countries served from Google Ads data. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| results | Yes |