Domain Analytics

Filter by device type. When omitted, countries are returned for every device type. Supported values: DESKTOP, MOBILE.

Country (database) code in ISO 3166-1 Alpha-2 format.

Device type the country’s data is available for. Possible values: DESKTOP, MOBILE.

Country (database) code in ISO 3166-1 Alpha-2 format, in any letter case, for example, us. The United Kingdom is gb; uk is rejected. A country that has no database for the selected device_type is rejected. Use the Get Supported Countries endpoint to get the supported country and device type pairs. Example: US

Device type of the search database. Supported values: DESKTOP, MOBILE. DESKTOP: the country’s desktop search database. MOBILE: the country’s mobile search database, which not every country has.

Month in ISO 8601 format (YYYY-MM). If omitted, the latest monthly snapshot for the selected country and device_type is returned. Example: 2024-12

Domains filter string. For syntax, refer to Advanced filtering. A money field is filtered by its numeric value alone, never by the pair: traffic_cost > 2.50, and the currency is never part of a filter. Available fields: rank, domain, positions, traffic, traffic_cost, organic_positions, organic_traffic, organic_traffic_cost, serp_features_positions, serp_features_traffic, serp_features_traffic_cost, adwords_positions, adwords_traffic, adwords_traffic_cost, pla_positions, pla_copies, positions_difference, traffic_difference, traffic_cost_difference, organic_positions_difference, organic_traffic_difference, organic_traffic_cost_difference, serp_features_positions_difference, serp_features_traffic_difference, serp_features_traffic_cost_difference, adwords_positions_difference, adwords_traffic_difference, adwords_traffic_cost_difference. Example: organic_traffic > 100

Field names from the response entity to include in the response. Supported values: rank, domain, month, positions, traffic, traffic_cost, organic_positions, organic_traffic, organic_traffic_cost, serp_features_positions, serp_features_traffic, serp_features_traffic_cost, adwords_positions, adwords_traffic, adwords_traffic_cost, pla_positions, pla_copies, positions_difference, traffic_difference, traffic_cost_difference, organic_positions_difference, organic_traffic_difference, organic_traffic_cost_difference, serp_features_positions_difference, serp_features_traffic_difference, serp_features_traffic_cost_difference, adwords_positions_difference, adwords_traffic_difference, adwords_traffic_cost_difference.

Maximum number of domain rankings to return. Default: 100. Maximum: 5,000. A value of 0 is rejected. The sum of limit and offset must not exceed 500,000.

Number of domain rankings to skip before returning results. Default: 0. The sum of limit and offset must not exceed 500,000; with the default limit of 100, the largest offset is 499,900.

Field name to sort by. Default: rank. Supported values: rank, domain, positions, traffic, traffic_cost, organic_positions, organic_traffic, organic_traffic_cost, serp_features_positions, serp_features_traffic, serp_features_traffic_cost, adwords_positions, adwords_traffic, adwords_traffic_cost, pla_positions, pla_copies, positions_difference, traffic_difference, traffic_cost_difference, organic_positions_difference, organic_traffic_difference, organic_traffic_cost_difference, serp_features_positions_difference, serp_features_traffic_difference, serp_features_traffic_cost_difference, adwords_positions_difference, adwords_traffic_difference, adwords_traffic_cost_difference.

Sorting direction (ascending or descending). Default: ASC. Supported values: ASC, DESC. Example: DESC

Visibility rank of the domain.

Domain name.

Month in ISO 8601 format (YYYY-MM).

Total number of keyword positions.

Total estimated traffic.

Organic search keyword positions.

Estimated organic traffic.

Organic position change compared to the previous period.

Organic traffic change compared to the previous period.

Paid search (AdWords) positions.

Estimated traffic from paid search.

Paid search position change compared to the previous period.

Paid search traffic change compared to the previous period.

Positions with SERP features.

Traffic from SERP features.

SERP feature position change compared to the previous period.

SERP feature traffic change compared to the previous period.

Product Listing Ads (PLA) positions.

Number of unique PLA ad copies.

Position change compared to the previous period.

Traffic change compared to the previous period.

Country (database) code in ISO 3166-1 Alpha-2 format, in any letter case, for example, us. The United Kingdom is gb; uk is rejected. A country that has no database for the selected device_type is rejected. Use the Get Supported Countries endpoint to get the supported country and device type pairs. Example: US

Device type of the search database. Supported values: DESKTOP, MOBILE.

Month in ISO 8601 format (YYYY-MM). If omitted, the latest monthly snapshot for the selected country and device_type is returned. Example: 2024-12

Domains filter string. For syntax, refer to Advanced filtering. A money field is filtered by its numeric value alone, never by the pair: traffic_cost > 2.50, and the currency is never part of a filter. Available fields: rank, domain, positions, traffic, traffic_cost, organic_positions, organic_traffic, organic_traffic_cost, serp_features_positions, serp_features_traffic, serp_features_traffic_cost, adwords_positions, adwords_traffic, adwords_traffic_cost, pla_positions, pla_copies, positions_difference, traffic_difference, traffic_cost_difference, organic_positions_difference, organic_traffic_difference, organic_traffic_cost_difference, serp_features_positions_difference, serp_features_traffic_difference, serp_features_traffic_cost_difference, adwords_positions_difference, adwords_traffic_difference, adwords_traffic_cost_difference Example: traffic > 100

Total number of matching domains.

Target URL to query. The length must not exceed 2,000 characters. Accepts URLs with or without the protocol (https://). Example: example.com

Part of the URL to include in the analysis. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE. Example: ROOT_DOMAIN

Month in ISO 8601 format (YYYY-MM). If omitted, the latest monthly snapshot for the selected country and device_type is returned. Example: 2024-12

Country (database) code in ISO 3166-1 Alpha-2 format, in any letter case. The United Kingdom is gb; uk is rejected. A country must have a database available for the selected device_type. Example: US

Search database device type. Supported values: DESKTOP, MOBILE. DESKTOP: the country’s desktop search database. MOBILE: the country’s mobile search database, which not every country has.

Field names from the response to include. If omitted, all fields are returned. Supported values: database, rank, month, organic_positions, organic_positions_branded, organic_positions_1_3, organic_positions_4_10, organic_positions_11_20, organic_positions_21_30, organic_positions_31_40, organic_positions_41_50, organic_positions_51_60, organic_positions_61_70, organic_positions_71_80, organic_positions_81_90, organic_positions_91_inf, organic_positions_new, organic_positions_lost, organic_positions_improved, organic_positions_declined, organic_traffic, organic_traffic_cost, organic_traffic_branded, organic_traffic_cost_branded, adwords_positions, adwords_positions_1, adwords_positions_2, adwords_positions_3, adwords_positions_4, adwords_positions_5, adwords_positions_6, adwords_positions_7, adwords_positions_8, adwords_positions_9, adwords_positions_10, adwords_positions_11_20, adwords_positions_21_inf, adwords_traffic, adwords_traffic_cost, pla_positions, pla_positions_1, pla_positions_2, pla_positions_3, pla_positions_4, pla_positions_5, pla_positions_6, pla_positions_7, pla_positions_8, pla_positions_9, pla_positions_10, pla_positions_11_20, pla_positions_21_30, pla_positions_31_inf, pla_copies, intent_commercial_positions, intent_informational_positions, intent_navigational_positions, intent_transactional_positions, intent_unknown_positions, intent_commercial_traffic, intent_informational_traffic, intent_navigational_traffic, intent_transactional_traffic, intent_unknown_traffic, intent_commercial_traffic_cost, intent_informational_traffic_cost, intent_navigational_traffic_cost, intent_transactional_traffic_cost, intent_unknown_traffic_cost, serp_features_positions, serp_features_traffic, serp_features_traffic_cost, serp_features_positions_branded, serp_features_traffic_branded, serp_features_traffic_cost_branded, serp_features_positions_lost, serp_features_positions_new, traffic, traffic_cost, traffic_branded, traffic_cost_branded, keyword_serp_features, position_serp_features.

Domain rank.

Month in ISO 8601 format (YYYY-MM).

Target URL to query. Maximum 2,000 characters. Accepts URLs with or without the protocol (https://). Example: example.com

Part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE. Example: ROOT_DOMAIN

Start date of the range. Format: ISO 8601 YYYY-MM. Example: 2024-01

End date of the range. Format: ISO 8601 YYYY-MM. Example: 2024-12

Country code in ISO 3166-1 Alpha-2 format (case-insensitive). For example, US for the United States, GB for the United Kingdom. Example: US

Device type of the search database. Supported values: DESKTOP, MOBILE. DESKTOP: desktop search database. MOBILE: mobile search database; not available for all countries. Example: DESKTOP

Metric names to include in the response. If omitted, all metrics are returned. Supported values include position metrics (for example, organic_positions, adwords_positions), traffic metrics (for example, organic_traffic, adwords_traffic), cost metrics (for example, organic_traffic_cost), intent-based metrics (for example, intent_commercial_positions), and SERP feature metrics (for example, serp_features_positions). Example: organic_positions,organic_traffic,adwords_positions

Month in ISO 8601 format (YYYY-MM). Always present whether or not requested in fields.

Rank of the target in the database for this month. Not set for a month without data.

Target URL to query. The length must not exceed 2,000 characters. Accepts URLs with or without the protocol (https://). Example: https://samplesite.com

scope determines which part of the URL will be taken into account. Required. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE. Example: ROOT_DOMAIN

Month in ISO 8601 format (YYYY-MM), for example, 2024-12. If omitted, the latest monthly snapshot for the selected country and device_type is returned. A month without a monthly snapshot is rejected; it is never replaced by the latest month.

Country (database) code in ISO 3166-1 Alpha-2 format, in any letter case, for example, us. The United Kingdom is gb; uk is rejected. A country that has no database for the selected device_type is rejected. Use the Get Supported Countries endpoint to get the supported country and device type pairs. Example: US

Device type of the search database. Supported values: DESKTOP, MOBILE. DESKTOP: the country’s desktop search database. MOBILE: the country’s mobile search database, which not every country has.

Type of positions to return. If omitted, organic and SERP-feature positions are both returned. Supported values: ORGANIC, SERP_FEATURE. ORGANIC: positions in the regular organic results only. SERP_FEATURE: positions inside SERP features only.

Position filter string. For syntax, refer to Advanced filtering. domain is not filterable (it is the resolved target and therefore constant across the list); intents and trends are not filterable either. A money field is filtered by its numeric value alone, never by the pair: cpc > 2.50, and the currency is never part of a filter. Available fields: competition_density, cpc, keyword, keyword_difficulty, keyword_serp_features, position, position_difference, position_previous, position_serp_features, results, traffic, traffic_cost, traffic_cost_percent, traffic_difference, traffic_difference_abs, traffic_percent, url, volume, is_keyword_branded, is_serp_feature, serp_feature. SERP-feature fields (serp_feature, keyword_serp_features, position_serp_features) take SerpFeature value names as quoted strings, never numeric IDs. The flags (is_keyword_branded, is_serp_feature) take true or false, case-insensitive; 1 and 0 are accepted as well. Filter values use the same units as the response fields, without implicit scaling: cpc is in USD (cpc > 2.50 means $2.50) and competition_density is on 0 to 100. position_previous and position_difference compare ranked months only: a keyword with no previous position never matches such a comparison, whatever the operator. Example: keyword = "seo" AND position > 10, serp_feature = "ADS_BOTTOM", keyword_serp_features HAS_ANY ("REVIEWS", "AI_OVERVIEW"), cpc > 2.50 AND volume > 1000, is_keyword_branded = true. Example: volume > 100

Field names from the response entity to include in the response. All if nothing is specified. A money field such as cpc or a *_traffic_cost selects the whole pair (value and currency), not a bare number. type is not selectable: it is set on every row. Supported values: competition_density, cpc, domain, keyword, keyword_difficulty, keyword_serp_features, position, position_difference, position_previous, position_serp_features, results, traffic, traffic_cost, traffic_cost_percent, traffic_difference, traffic_difference_abs, traffic_percent, trends, url, volume, intents, is_keyword_branded, is_serp_feature, serp_feature.

Maximum number of positions to return. Default: 100. Maximum: 5,000. A value of 0 is rejected. The sum of limit and offset must not exceed 500,000.

Number of positions to skip before returning results. Default: 0. The sum of limit and offset must not exceed 500,000; with the default limit of 100, the largest offset is 499,900.

Field name to sort by. Default: volume. domain is not sortable: it is the resolved target and therefore constant across the list. The repeated fields (keyword_serp_features, position_serp_features, trends, intents) are not sortable either: a list has no single value to order by. Money fields sort by their numeric value. Sorting by position_previous puts the new rankings, which have none, last in either direction. Supported values: competition_density, cpc, keyword, keyword_difficulty, position, position_difference, position_previous, results, traffic, traffic_cost, traffic_cost_percent, traffic_difference, traffic_difference_abs, traffic_percent, url, volume, is_keyword_branded, is_serp_feature, serp_feature.

Sorting direction (ascending or descending). Default: DESC. Supported values: ASC, DESC. Example: DESC

Competition level of advertisers bidding on the keyword in paid search. Range: 0–100, where 100 is most competitive.

Ranking domain.

Search intents associated with the keyword. Possible values: COMMERCIAL, INFORMATIONAL, NAVIGATIONAL, TRANSACTIONAL.

Specifies whether the keyword includes a brand name.

Specifies whether the position is a SERP feature rather than an organic result.

Keyword.

Keyword difficulty score (0–100).

List of SERP features present for the keyword.

Current organic position.

Change in position (previous minus current; positive when ranking improved). Absent when there is no previous position.

Previous organic position. Absent when the keyword did not rank in the previous month.

List of SERP features of the position.

Number of search results for the keyword.

Type of SERP feature if this is a SERP feature position (for example, INSTANT_ANSWER, FEATURED_SNIPPET).

Estimated monthly traffic from the keyword.

Share of keyword’s cost in total domain traffic cost as a percentage. Range: 0–100.

Change in traffic (can be negative).

Absolute value of traffic change.

Share of keyword traffic in total domain traffic as a percentage. Range: 0–100.

Monthly search volume trend data. Each value is a relative index on a 0–100 scale.

Position type: ORGANIC or SERP_FEATURE.

URL ranking for the keyword.

Monthly search volume.

Target URL to query. The length must not exceed 2,000 characters. Accepts URLs with or without the protocol (https://). Example: https://example.com

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE. Example: ROOT_DOMAIN

Month in ISO 8601 format (YYYY-MM). If omitted, the latest monthly snapshot for the selected country and device_type is returned. A month without a snapshot is rejected and never replaced with the latest month. Example: 2024-12

Country code in ISO 3166-1 Alpha-2 format, case-insensitive. The United Kingdom is gb; uk is rejected. A country with no database for the selected device_type is rejected. Use the Get Supported Countries endpoint to get available country and device type pairs. Example: US

Search database device type. Supported values: DESKTOP, MOBILE. DESKTOP for the country’s desktop database; MOBILE for mobile (not all countries have a mobile database).

Type of positions to return. If omitted, both organic and SERP-feature positions are included. Supported values: ORGANIC, SERP_FEATURE. ORGANIC for regular organic results only; SERP_FEATURE for SERP features only.

Position filter string. For syntax, refer to Advanced filtering. domain is not filterable (it is the resolved target and therefore constant across the list); intents and trends are not filterable either. A money field is filtered by its numeric value alone, never by the pair: cpc > 2.50, and the currency is never part of a filter. Available fields: competition_density, cpc, keyword, keyword_difficulty, keyword_serp_features, position, position_difference, position_previous, position_serp_features, results, traffic, traffic_cost, traffic_cost_percent, traffic_difference, traffic_difference_abs, traffic_percent, url, volume, is_keyword_branded, is_serp_feature, serp_feature. SERP-feature fields (serp_feature, keyword_serp_features, position_serp_features) take SerpFeature value names as quoted strings, never numeric IDs. The flags (is_keyword_branded, is_serp_feature) take true or false, case-insensitive; 1 and 0 are accepted as well. Filter values use the same units as the response fields, without implicit scaling: cpc is in USD (cpc > 2.50 means $2.50) and competition_density is on 0 to 100. position_previous and position_difference compare ranked months only: a keyword with no previous position never matches such a comparison, whatever the operator. Example: position > 10 AND volume > 1000

Target URL to query. The length must not exceed 2,000 characters. Accepts URLs with or without the protocol (https://). Example: https://example.com

Which part of the URL to analyze. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE. Example: ROOT_DOMAIN

Earlier month of the comparison. Must be earlier than comparison_month. Values for this month are returned in the *_previous fields. Format: ISO 8601 YYYY-MM (for example, 2024-01).

Later month of the comparison, compared against base_month. Values for this month are returned in the fields without the _previous suffix. Format: ISO 8601 YYYY-MM (for example, 2024-12).

Country database code in ISO 3166-1 Alpha-2 format, in any letter case (for example, us). The United Kingdom is gb; uk is rejected. A country that has no database for the selected device_type is rejected. Use the Get Supported Countries endpoint to get the supported country and device type pairs. Example: US

Device type of the search database. Supported values: DESKTOP, MOBILE. DESKTOP: the country’s desktop search database. MOBILE: the country’s mobile search database, which not every country has.

Type of positions to return. If omitted, organic and SERP-feature positions are both returned. Supported values: ORGANIC, SERP_FEATURE. ORGANIC: positions in the regular organic results only. SERP_FEATURE: positions inside SERP features only.

Types of position changes to return. All if nothing is specified. A ranking is one keyword at one URL, in the regular results or in one SERP feature; a keyword whose ranking URL changed is LOST at the old URL and NEW at the new one. Supported values:

- NEW: The ranking exists in comparison_month but not in base_month. - LOST: The ranking exists in base_month but not in comparison_month. - IMPROVED: A ranking present in both months moved to a better position (a lower position number), in the regular results or in a SERP feature. - DECLINED: A ranking present in both months moved to a worse position (a higher position number), in the regular results or in a SERP feature. - UNCHANGED: The position is the same in both months; such a ranking is returned only when its traffic estimate changed.

Every returned change has one of these types, so requesting all five returns the same changes as omitting this parameter.

Position changes filter string. For syntax, refer to Advanced filtering. intents, keyword_serp_features_new and keyword_serp_features_lost are not filterable. A money field is filtered by its numeric value alone, never by the pair: cpc > 2.50, and the currency is never part of a filter. Available fields: keyword, url, volume, position, position_difference, position_previous, traffic, traffic_previous, traffic_cost, traffic_cost_previous, traffic_cost_percent, traffic_difference, traffic_percent, competition_density, cpc, keyword_difficulty, results, is_keyword_branded, is_serp_feature, serp_feature, traffic_difference_abs, is_branded. The serp_feature field takes SerpFeature value names as quoted strings, never numeric IDs. The flags (is_keyword_branded, is_serp_feature, is_branded) take true or false, case-insensitive; 1 and 0 are accepted as well. Filter values use the same units as the response fields, without implicit scaling: cpc is in USD (cpc > 2.50 means $2.50) and competition_density is on 0 to 100. position, position_previous and position_difference compare ranked months only: a LOST change has no position, a NEW change no previous one, neither has a difference, and none matches such a comparison whatever the operator (position > 10 excludes LOST rows). Example: keyword = "seo" AND position > 10, serp_feature = "ADS_BOTTOM", cpc > 2.50 AND volume > 100, is_branded = true. Example: volume > 100

Field names from the response entity to include in the response. All if nothing is specified. A money field such as cpc or a *_traffic_cost selects the whole pair (value and currency), not a bare number. Supported values: keyword, url, volume, position, position_difference, position_previous, traffic, traffic_previous, traffic_cost, traffic_cost_previous, traffic_cost_percent, traffic_difference, traffic_percent, competition_density, cpc, keyword_difficulty, keyword_serp_features_new, keyword_serp_features_lost, results, intents, is_keyword_branded, is_serp_feature, serp_feature, traffic_difference_abs, is_branded.

Maximum number of position changes to return. Default: 100. Maximum: 5,000. A value of 0 is rejected. The sum of limit and offset must not exceed 500,000.

Number of position changes to skip before returning results. Default: 0. The sum of limit and offset must not exceed 500,000; with the default limit of 100, the largest offset is 499,900.

Field name to sort by. Default: traffic_difference_abs. Money fields sort by their numeric value. Not sortable: the repeated fields (keyword_serp_features_new, keyword_serp_features_lost, intents), the flags (is_keyword_branded, is_serp_feature, is_branded) and serp_feature. Sorting by position, position_previous or position_difference puts the changes without that value (LOST, NEW) last in either direction. Supported values: keyword, url, volume, position, position_difference, position_previous, traffic, traffic_previous, traffic_cost, traffic_cost_previous, traffic_cost_percent, traffic_difference, traffic_percent, competition_density, cpc, keyword_difficulty, results, traffic_difference_abs.

Sorting direction (ascending or descending). Default: DESC. Supported values: ASC, DESC. Example: DESC

Type of ranking change. One of: NEW (exists in comparison month only), LOST (exists in base month only), IMPROVED (moved to better position), DECLINED (moved to worse position), or UNCHANGED (same position but traffic changed).

Keyword associated with the ranking change.

URL associated with the ranking change.

Monthly search volume for the keyword.

Current organic position in the comparison month. Absent for LOST changes (keyword does not rank in comparison month).

Organic position in the base month. Absent for NEW changes (keyword did not rank in base month).

Change in position (position_previous minus position). Positive when ranking improved. Absent for NEW or LOST changes.

Current estimated traffic to this keyword’s ranking in the comparison month.

Estimated traffic to this keyword’s ranking in the base month.

Change in estimated traffic.

Absolute value of traffic change.

Share of this keyword’s traffic in total domain traffic as a percentage (0–100).

Current traffic cost in USD (comparison month).

Previous traffic cost in USD (base month).

Share of this keyword’s cost in total domain traffic cost as a percentage (0–100).

Competition level of advertisers bidding on the keyword in paid search (0–100, where 100 is most competitive).

Cost per click of the keyword in USD.

Keyword difficulty score (0–100).

Number of search results for the keyword.

Position type: ORGANIC (regular organic results) or SERP_FEATURE (inside SERP feature block).

Whether the URL was obtained from a SERP feature block instead of regular organic results.

Type of SERP feature (for example, FEATURED_SNIPPET, ADS_BOTTOM, KNOWLEDGE_PANEL). Absent for regular organic results.

List of new SERP features the keyword now appears in (for example, FEATURED_SNIPPET, KNOWLEDGE_PANEL). Empty if no new features in comparison month.

List of SERP features the keyword no longer appears in. Empty if no features were lost.

Search intents associated with the keyword. Possible values: COMMERCIAL, INFORMATIONAL, NAVIGATIONAL, TRANSACTIONAL.

Whether the keyword is branded for one of the domains on the SERP.

Whether the keyword is branded for this domain specifically.

Target URL to query. The length must not exceed 2,000 characters. Accepts URLs with or without the protocol (https://). Example: https://example.com

scope determines which part of the URL will be taken into account. Required. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE. Example: ROOT_DOMAIN

Earlier month of the comparison. Must be earlier than comparison_month. Format: ISO 8601 YYYY-MM (for example, 2024-01).

Later month of the comparison, compared against base_month. Format: ISO 8601 YYYY-MM (for example, 2024-12).

Country (database) code in ISO 3166-1 Alpha-2 format, in any letter case, for example, us. The United Kingdom is gb; uk is rejected. A country that has no database for the selected device_type is rejected. Use the Get Supported Countries endpoint to get the supported country and device type pairs. Example: us

Search database type. Supported values: DESKTOP, MOBILE. DESKTOP: the country’s desktop search database. MOBILE: the country’s mobile search database, which not every country has. Example: DESKTOP

Type of positions to return. If omitted, organic and SERP-feature positions are both returned. Supported values: ORGANIC, SERP_FEATURE. ORGANIC: positions in the regular organic results only. SERP_FEATURE: positions inside SERP features only.

Types of position changes to return. All if nothing is specified. A ranking is one keyword at one URL, in the regular results or in one SERP feature; a keyword whose ranking URL changed is LOST at the old URL and NEW at the new one. Supported values:

- NEW: The ranking exists in comparison_month but not in base_month. - LOST: The ranking exists in base_month but not in comparison_month. - IMPROVED: A ranking present in both months moved to a better position (a lower position number), in the regular results or in a SERP feature. - DECLINED: A ranking present in both months moved to a worse position (a higher position number), in the regular results or in a SERP feature. - UNCHANGED: The position is the same in both months; such a ranking is returned only when its traffic estimate changed.

Every returned change has one of these types, so requesting all five returns the same changes as omitting this parameter.

Position changes filter string. For syntax, refer to Advanced filtering. intents, keyword_serp_features_new and keyword_serp_features_lost are not filterable. Money fields are filtered by their numeric value alone, never by currency: cpc > 2.50 means $2.50 USD. Available fields: keyword, url, volume, position, position_difference, position_previous, traffic, traffic_previous, traffic_cost, traffic_cost_previous, traffic_cost_percent, traffic_difference, traffic_percent, competition_density, cpc, keyword_difficulty, results, is_keyword_branded, is_serp_feature, serp_feature, traffic_difference_abs, is_branded. The serp_feature field takes SerpFeature value names as quoted strings. Boolean flags (is_keyword_branded, is_serp_feature, is_branded) accept true or false (case-insensitive), and also 1 or 0. Filter values use the same units as response fields. For ranked changes only: a LOST change has no position, a NEW change no previous position, neither has a difference, and position-based filters exclude unranked rows. Example: keyword = "seo" AND position > 10

Response data containing the position changes total.

Target URL to query. The length must not exceed 2,000 characters. Accepts URLs with or without the protocol (https://). Example: example.com

Part of the URL to include in the analysis. Supported values: ROOT_DOMAIN, SUBDOMAIN, SUBFOLDER, PAGE. Example: ROOT_DOMAIN

Month in ISO 8601 format (YYYY-MM). If omitted, the latest monthly snapshot for the selected country and device_type is returned. Example: 2024-12

Country (database) code in ISO 3166-1 Alpha-2 format, in any letter case. The United Kingdom is gb; uk is rejected. A country must have a database available for the selected device_type. Example: US

Device type of the search database. Supported values: DESKTOP, MOBILE. DESKTOP: the country’s desktop search database. MOBILE: the country’s mobile search database, which not every country has.

Pages filter string. For syntax, refer to Advanced filtering. If omitted, no filter is applied. Available fields: url, organic_positions, organic_traffic, adwords_positions, intent_breakdown.top_20.commercial.positions, intent_breakdown.top_20.informational.positions, intent_breakdown.top_20.navigational.positions, intent_breakdown.top_20.transactional.positions, intent_breakdown.top_20.unknown.positions, intent_breakdown.top_20.commercial.traffic, intent_breakdown.top_20.informational.traffic, intent_breakdown.top_20.navigational.traffic, intent_breakdown.top_20.transactional.traffic, intent_breakdown.top_20.unknown.traffic, serp_features_positions, serp_features_traffic, positions, traffic, traffic_percent. The url field accepts text operators CONTAINS, STARTS_WITH, ENDS_WITH (case-sensitive) and exact match operators =, !=, IN. All other fields accept numeric operators: =, !=, >, >=, <, <=, IN. Example: organic_traffic > 50

Field names from the response to include. If omitted, all fields are returned. Supported values: url, organic_positions, organic_traffic, adwords_positions, intent_breakdown.top_20.commercial.positions, intent_breakdown.top_20.informational.positions, intent_breakdown.top_20.navigational.positions, intent_breakdown.top_20.transactional.positions, intent_breakdown.top_20.unknown.positions, intent_breakdown.top_20.commercial.traffic, intent_breakdown.top_20.informational.traffic, intent_breakdown.top_20.navigational.traffic, intent_breakdown.top_20.transactional.traffic, intent_breakdown.top_20.unknown.traffic, serp_features_positions, serp_features_traffic, positions, traffic, traffic_percent.

Maximum number of pages to return. Default: 100. Maximum: 5,000. A value of 0 is rejected. The sum of limit and offset must not exceed 500,000.

Number of pages to skip before returning results. Default: 0. The sum of limit and offset must not exceed 500,000.

Field name to sort by. Default: traffic. Supported values: url, organic_positions, organic_traffic, adwords_positions, intent_breakdown.top_20.commercial.positions, intent_breakdown.top_20.informational.positions, intent_breakdown.top_20.navigational.positions, intent_breakdown.top_20.transactional.positions, intent_breakdown.top_20.unknown.positions, intent_breakdown.top_20.commercial.traffic, intent_breakdown.top_20.informational.traffic, intent_breakdown.top_20.navigational.traffic, intent_breakdown.top_20.transactional.traffic, intent_breakdown.top_20.unknown.traffic, serp_features_positions, serp_features_traffic, positions, traffic, traffic_percent.

Sorting direction. Default: DESC. Supported values: ASC, DESC. ASC: ascending, smallest value first. DESC: descending, largest value first. Example: DESC

Ranking page URL.

Number of organic keyword positions.

Estimated organic traffic.

Number of paid (AdWords) keyword positions.

Number of positions with SERP features.

Traffic from positions with SERP features.

Total number of positions (computed as organic_positions + serp_features_positions). Paid (AdWords) positions are not included.

Total estimated traffic.

Share of this page’s traffic relative to the domain as a percentage (0–100).