start_keyword_research
Request keyword suggestions for an explicitly reviewed seed and market, or (mode=“gap”) the keywords a competitor ranks for that this website does not. Read get_keyword_research first for supported country/language pairs and the competitors list. seed (keywords mode) is at most 80 characters; competitor (gap mode) is a domain such as rival.com, not this website. country and language are two-letter codes. gap_scope defaults to non_brand (excludes the competitor name); comparisons selects branded comparison/alternative wording, and brand selects other branded searches. Categories use name/word matching, not intent analysis; comparison wording is currently English-only. Each scope is a separate cached paid lookup. A new request records a $0.05 pending cost estimate, then settles the actual provider cost. Research has no monthly spending cap by default. The same mode and normalized seed or competitor, site, market and language is cached for the calendar month, including failed attempts; never replay an attempted paid request. Returns run metadata; poll get_keyword_research with its id as run_id for queued/running results (up to 100 suggestions plus seed, or up to 100 gap keywords with the competitor’s position). This does not activate monitoring or publish content.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
site_source_id | string | yes | ||
country | string | yes | ||
language | string | yes | ||
seed | string | no | "" | |
mode | string | no | "keywords" | |
competitor | string | no | "" | |
gap_scope | string | no | "non_brand" |
Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.