Organic keywords
API + MCPQuery parameters
A manual timeout duration in seconds.
The number of results to return.
A comma-separated list of columns to order results by, with optional direction. See response schema for valid column identifiers.
The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the select parameter).
A comma-separated list of columns to return. See response schema for valid column identifiers.
The protocol of your target.
The target of the search: a domain or a URL.
The scope of the search based on the target you entered.
A two-letter country code (ISO 3166-1 alpha-2).
A date to compare metrics with in YYYY-MM-DD format.
A date to report metrics on in YYYY-MM-DD format.
The search volume calculation mode: monthly or average. It affects volume, traffic, and traffic value.
The output format.
Responses
(5 units) The list of all positions for a keyword.
(5 units) The list of all positions for a keyword on the comparison date.
The top position your target ranks for in the organic search results for a keyword.
The change in position between your selected dates.
The top position has a thumbnail.
The top position has a thumbnail on the comparison date.
The top position has a video.
The top position has a video on the comparison date.
The kind of the top position: organic, paid, or a SERP feature.
The kind of the top position optimized for sorting.
The kind of the top position on the comparison date.
The top position on the comparison date.
The ranking group of the top position.
The ranking group of the top position on the comparison date.
The ranking URL in organic search results.
The ranking URL on the comparison date.
Cost Per Click shows the average price that advertisers pay for each ad click in paid search results for a keyword, in USD cents.
The CPC field optimized for sorting.
The CPC metric on the comparison date.
Organizations, products, persons, works, events, and locations found in a keyword.
The ranking group of the top position is 11-50.
The ranking group of the top position was 11-50 on the comparison date.
The ranking group of the top position is Top 3.
The ranking group of the top position was Top 3 on the comparison date.
The ranking group of the top position is 4-10.
The ranking group of the top position was 4-10 on the comparison date.
User intent: branded. The user is searching for a specific brand or company name.
User intent: commercial. The user is comparing products or services before making a purchase decision.
User intent: informational. The user is looking for information or an answer to a specific question.
User intent: local. The user is looking for information relevant to a specific location or nearby services.
User intent: navigational. The user is searching for a specific website or web page.
User intent: transactional. The user is ready to complete an action, often a purchase.
The keyword your target ranks for.
The country of a keyword your target ranks for.
(10 units) An estimation of how hard it is to rank in the top 10 organic search results for a keyword on a 100-point scale.
(10 units) The keyword difficulty field optimized for sorting.
(10 units) The keyword difficulty on the comparison date.
The language of the search query
The keyword field optimized for sorting.
The keyword your target ranks for on the comparison date.
The SERP language.
The SERP language on the comparison date.
The date when we last checked search engine results for a keyword.
The date when we checked search engine results up to the comparison date.
The SERP features that appear in search results for a keyword.
The number of SERP features that appear in search results for a keyword.
The number of SERP features on the comparison date.
The SERP features field optimized for sorting.
The SERP features that appear in search results for a keyword on the comparison date.
The number of target URLs ranking for a keyword excluding positions in Sitelinks, Top stories, Image packs, and posts on X (Twitter).
The number of target URLs ranking for a keyword excluding positions in Sitelinks, Top stories, Image packs, and posts on X (Twitter) on the comparison date.
The number of target URLs ranking for a keyword.
The number of target URLs ranking for a keyword on the comparison date.
The status of a page: the new page that just started to rank ("left"), the lost page that disappeared from search results ("right"), or no change ("both").
(10 units) An estimation of the number of monthly visits that your target gets from paid search for a keyword.
(10 units) The paid traffic field optimized for sorting.
(10 units) The paid traffic on the comparison date.
(10 units) An estimation of the number of monthly visitors that your target gets from organic search for a keyword.
(10 units) The traffic field optimized for sorting.
(10 units) The traffic on the comparison date.
(10 units) An estimation of the number of searches for a keyword over the latest month.
The percentage of the total search volume that comes from desktop devices.
(10 units) The search volume field optimized for sorting.
The percentage of the total search volume that comes from mobile devices.
(10 units) The search volume on the comparison date.
The number of words in a keyword.
The number of words in a keyword optimized for sorting.
The number of words in a keyword on the comparison date.