Developer
Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Basic docs
Analytics
Last updated: April 3, 2024
Last updated: April 3, 2024
About
It’s a group of products with Analytics reports including:
- Domain Analytics
- Organic Research
- Advertising Research
- Keyword Gap Analysis
- Keyword Analytics
- Backlink Analytics
Auth
Request authenification is provided via API key.
You can find info how to get your in How to get API documentation.
If you sent an API call example, replace your key with a placeholder (e.g. https://api.semrush.com/?key=<key>).
Your API key also gives an access to your API units balance, so please don’t share it publicly.
Exposing your credentials can result in your account being compromised, which leads to unexpected charges.
Columns
Tips and tricks:
- Column names can't be changed
- Order of columns can be changed
- Number of columns can be increased
- Semrush will only remove old columns after notifying users
| Name | Description |
|---|---|
| Ab | Place on the SERP where an ad appeared (top, side, or bottom blocks). |
| Ac | Estimated budget spent buying keywords in Google Ads for ads that appear in paid search results (monthly estimation). |
| Ad | Keywords a website is buying in Google Ads for ads that appear in paid search results. |
| Am | Changes in the number of paid keywords. |
| At | Traffic brought to the website via paid search results. |
| Bm | Changes in paid traffic. |
| Cg | Total cost of all traffic driven to an analyzed domain with a given keyword over a specific period of time. |
| Cm | Changes in paid traffic price. |
| Co | Competitive density of advertisers using the given term for their ads. One (1) means the highest competition. |
| Cp | Average price in USD advertisers pay for a user's click on an ad containing a particular keyword (Google AdWords). |
| Cr | Competition level based on the total number of keywords of each domain and the number of keywords the domains have in common. |
| Cv | Keyword coverage represents the percentage of ads displayed for a particular keyword in the last 12 months (100% = 12 months). |
| Db | Regional database (US, UK, Italy, etc.). |
| Dn | Domain name. |
| Ds | Ad text. |
| Dt | Actual date. |
| Fk | All SERP Features triggered by a keyword. List of available SERP Features |
| Fp | SERP features in which a domain appears on SERP for a keyword. List of available SERP Features |
| Fl | (Deprecated) SERP features in which a domain appears on SERP for a keyword. List of available SERP Features |
| FKn | Total number of SERP Features triggered by the keywords that your domain ranks for. Columns with specified numbers should be separated with commas: FK1,FK2..FKn, where n is the number of a SERP feature from this list. |
| FPn | Total number of SERP Features that your domain ranks in. Columns with changed numbers should be separated with commas: FP1,FP2..FPn, where n is the number of a SERP feature from this list. |
| Hs | Whether or not a report's line returns historical data. |
| Ip | IP address. |
| In | Keyword intents (0 - Commercial, 1 - Informational, 2 - Navigational, 3 - Transactional). |
| Ipu | Total number of positions with unknown intent. |
| Ip0 | Total number of positions with the Commercial intent. |
| Ip1 | Total number of positions with the Informational intent. |
| Ip2 | Total number of positions with the Navigational intent. |
| Ip3 | Total number of positions with the Transactional intent. |
| Itu | Total amount of traffic with unknown intent. |
| It0 | Total amount of traffic with the Commercial intent. |
| It1 | Total amount of traffic with the Informational intent. |
| It2 | Total amount of traffic with the Navigational intent. |
| It3 | Total amount of traffic with the Transactional intent. |
| Icu | Total cost of traffic with unknown intent. |
| Ic0 | Total cost of traffic with the Commercial intent. |
| Ic1 | Total cost of traffic with the Informational intent. |
| Ic2 | Total cost of traffic with the Navigational intent. |
| Ic3 | Total cost of traffic with the Transactional intent. |
| Kd | Estimate of how difficult it would be to rank well in organic search results for a particular keyword. The higher the percentage, the harder it is to achieve high rankings for the given keyword. |
| Lc | Number of API units per line. |
| Li | Number of lines requested for a report by a particular user. |
| Np | Common keywords that domains are ranking for in Google's top 100 organic search results. |
| Nq | Average number of times users have searched for a given keyword per month. We calculate this value over the last 12 months. |
| Nr | Total number of organic results returned for a given keyword at the last date of collection. |
| Oc | Estimated price of organic keywords in Google AdWords. |
| Oe | Keywords that the domain is still ranking for within the top 100 positions for, but has moved up in ranking since their previous position. |
| Of | Value of the display_offset parameter requested by a particular user. |
| Oi | Results that have decreased in ranking, yet still remain in the top 100. |
| Ol | Keywords that the domain was previously ranking for within the top 100 positions, but isn't any longer. |
| Om | Changes in the number of organic keywords. |
| On | New keywords that the domain is ranking for within the top 100 organic results based on the chosen time period. |
| Or | Keywords that bring users to a website via Google's top 100 organic search results. |
| Ot | Traffic brought to a website via Google's top 100 organic search results. |
| P0 | Position of the first queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| P1 | Position of the second queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| P2 | Position of the third queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| P3 | Position of the fourth queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| P4 | Position of the fifth queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| Pc | Number of keywords. |
| Pd | Difference between the previous position a domain was earning with a particular keyword and its current position. |
| Ph | Keyword bringing users to the website via Google's top 100 organic search results. |
| Po | Position the URL gets with a particular keyword in Google's top 100 organic or paid search results. |
| Pp | Position the domain gets with a particular keyword in Google's top 100 organic or paid search results. |
| Pr | Price of promoted product. |
| Pt | Type of position (the regular organic position or the specific SERP Feature). |
| Rh | Semrush rating of the website's popularity based on organic traffic coming from Google's top 100 organic search results. |
| Rk | Semrush rating of the website's popularity based on organic traffic coming from Google's top 100 organic search results. |
| Rr | Degree of relevance of the result keyword to the seed keyword. |
| Rt | Report type. |
| Sc | Estimated price to pay for the PPC ads to rank for the keywords where the domain is ranking in the SERP Features. |
| Scm | Changes in the organic traffic cost driven by SERP Feature positions. |
| Sh | Number of keywords the website is using for product listing ads. |
| Sn | Shop name. |
| Sv | Number of unique product listing ads (PLA Copies). |
| Sr | Number of keywords where the domain ranks in SERP Features. |
| Srb | Number of branded keywords where the domain ranks in SERP Features. |
| Srl | Keywords that the domain was previously ranking for in SERP Features, but isn't any longer. |
| Srm | Changes in the number of keywords with SERP Feature positions. |
| Srn | New keywords that the domain is ranking for in SERP Features based on the chosen time period. |
| St | Amount of estimated organic traffic driven to an analyzed domain from a SERP Feature position over a specific period of time. |
| Stb | Amount of estimated organic traffic driven to an analyzed domain from a SERP Feature position on a branded keyword over a specific period of time. |
| Stm | Changes in the traffic driven by SERP Feature postions. |
| Tc | Percentage of the domain's total traffic cost that is attributed to a particular keyword. |
| Tg | Amount of estimated organic traffic driven to an analyzed domain with a given keyword over a specific period of time. |
| Td | Interest of searchers in a particular keyword during the last 12 months. This metric is based on changes in the number of queries per month. |
| Tm | Changes in organic traffic. |
| Tr | Share of traffic driven to the website with a particular keyword for a specified period. |
| Ts | UNIX Timestamp. |
| Tt | Ad title. |
| Um | Changes in organic traffic cost. |
| Un | Ad ID. |
| Ur | URL of the target page (Backlinks). |
| Vu | Visible URL. |
| Xn |
Organic Position Distribution. Keywords bringing users to the website via Google's top 100 organic search results are grouped depending on the domain’s ranking for them. Columns with specified numbers should be separated with commas: X0,X1..Xn, where n is: 0: 1-31: 4-102: 11-203: 21-304: 31-405: 41-506: 51-607: 61-708: 71-809: 81-90a: 91-100+ |
| ads_count | Total number of all types of display ads (media and text) during a specified period. |
| ads_overall | Total number of all types of display ads (media and text) for all time. |
| advertisers_count | Total number of advertisers on Google’s Display Network where a publisher promoted the website in the last 7 days. |
| advertisers_overall | Total number of advertisers on Google’s Display Network where a publisher promoted the website. |
| anchor | Clickable backlink text. |
| ascore | Authority Score is a Semrush proprietary metric used to measure the overall quality of the domain/URL and its influence on SEO. The score is based on the number of backlinks, referring domains, organic search traffic, and other data. |
| avg_positions | Average ad position. |
| backlinks_num | Number of backlinks to a given domain. |
| category_name | Name of the category. Categories may consist of one, two or three levels. Levels are divided by a slash (/). Example of one-level category: “/Business & Industrial”. Example of three-level category: “/Internet & Telecom/Web Services/Web Design & Development” |
| common_refdomains | The number of referring domains that link back to both the analyzed and competing domains. |
| domain | Domain name. |
| domain_ascore | Domain Authority Score is our proprietary metric used to measure overall quality of domain and influence on SEO. The score is based on the number of backlinks, referring domains, organic search traffic, and other data. |
| domain_overall | Total number of advertisers on Google’s Display Network where a publisher promoted a website, or the total number of publishers’ websites where the display ads of an advertiser's website appeared during a whole period. |
| domains_num | Total number of domains, including common referring domains, linking to a given domain. |
| external_num | Number of the source page's links that point to pages of other websites. |
| first_seen | Timestamp on which Semrush first noticed a backlink. |
| image_alt | URL of the image backlink's location. |
| internal_num | Number of the source page’s links that point to webpages of the same website. |
| ipclassc_num | Number of unique IP addresses of referring domains belonging to class C. Class C networks range from 192.0.0.0 through 223.255.255.0, with the network number contained in the first three octets. |
| ips_num | Number of unique IP addresses hosting referring domains. |
| last_seen | Timestamp on which Semrush last noticed a backlink. |
| media_ads_count | Total number of media display ads of an advertiser Semrush has noticed during a specified period. |
| media_ads_overall | Total number of an advertiser’s media display ads Semrush has noticed for a whole period. |
| media_type | Display ad's type of media. |
| neighbour | Domain with a similar backlink profile to the analyzed domain. |
| page_ascore | Page Authority Score is a proprietary Semrush metric used to measure the overall quality of the URL and its influence on SEO. The score is based on the number of backlinks, referring domains, organic search traffic, and other data. |
| publishers_count | Total number of publishers' websites where display ads of an advertiser's website appeared in the last 7 days. |
| publishers_overall | Total number of publishers’ websites where the display ads of an advertiser's website appeared during a whole period. |
| rating | Level of confidence that this domain belongs to this category (ranged from 0 to 1). |
| redirect_url | Last URL in a redirect chain. |
| response_code | Server response code. |
| similarity | This metric is calculated based on the number of referring domains to each competitor and the total number of common referring domains to all competitors. If websites have a large number of common referring domains, they can be considered competitors. |
| source_title | Title of the source page. |
| source_size | Size of the source page in bytes. |
| source_url | URL of the source page. |
| target_title | Title of the target page. |
| target_url | URL of the target page (Backlinks). |
| target_url | Landing page of a display ad (Display Advertising). |
| text | Text of a display ad. |
| text_ads_count | Total number of display ads during a specified period. |
| text_ads_overall | Total number of display ads Semrush noticed for a whole period. |
| times_seen | Number of times Semrush saw a display ad. |
| title | Title of a display ad. |
| total | Total number of backlinks leading to an analyzed domain/URL. |
| type | Backlink type. |
| ugc_num | Number of backlinks identified as User Generated Content (UGC). |
| visible_url | Visible URL of a display ad. |
| zone | Domain TLD. |
Show all
Databases
| Code | Region | Research types | Google search domain |
|---|---|---|---|
| us | United States | Organic, Adwords, PLA, Keywords | google.com |
| uk | United Kingdom | Organic, Adwords, PLA, Keywords | google.co.uk |
| ca | Canada | Organic, Adwords, PLA, Keywords | google.ca |
| ru | Russia | Organic, Adwords, PLA, Keywords | google.ru |
| de | Germany | Organic, Adwords, PLA, Keywords | google.de |
| fr | France | Organic, Adwords, PLA, Keywords | google.fr |
| es | Spain | Organic, Adwords, PLA, Keywords | google.es |
| it | Italy | Organic, Adwords, PLA, Keywords | google.it |
| br | Brazil | Organic, Adwords, PLA, Keywords | google.com.br |
| au | Australia | Organic, Adwords, PLA, Keywords | google.com.au |
| ar | Argentina | Organic, Adwords, PLA, Keywords | google.com.ar |
| be | Belgium | Organic, Adwords, PLA, Keywords | google.be |
| ch | Switzerland | Organic, Adwords, PLA, Keywords | google.ch |
| dk | Denmark | Organic, Adwords, PLA, Keywords | google.dk |
| fi | Finland | Organic, Adwords, Keywords | google.fi |
| hk | Hong Kong | Organic, Adwords, PLA, Keywords | google.com.hk |
| ie | Ireland | Organic, Adwords, PLA, Keywords | google.ie |
| il | Israel | Organic, Adwords, Keywords | google.co.il |
| mx | Mexico | Organic, Adwords, PLA, Keywords | google.com.mx |
| nl | Netherlands | Organic, Adwords, PLA, Keywords | google.nl |
| no | Norway | Organic, Adwords, PLA, Keywords | google.no |
| pl | Poland | Organic, Adwords, PLA, Keywords | google.pl |
| se | Sweden | Organic, Adwords, PLA, Keywords | google.se |
| sg | Singapore | Organic, Adwords, PLA, Keywords | google.com.sg |
| tr | Turkey | Organic, Adwords, PLA, Keywords | google.com.tr |
| jp | Japan | Organic, Adwords, PLA, Keywords | google.co.jp |
| in | India | Organic, Adwords, PLA, Keywords | google.co.in |
| hu | Hungary | Organic, Adwords, Keywords | google.hu |
| af | Afghanistan | Organic, Adwords, Keywords | google.com.af |
| al | Albania | Organic, Adwords, Keywords | google.al |
| dz | Algeria | Organic, Adwords, Keywords | google.dz |
| ao | Angola | Organic, Adwords, Keywords | google.co.ao |
| am | Armenia | Organic, Adwords, Keywords | google.am |
| at | Austria | Organic, Adwords, PLA, Keywords | google.at |
| az | Azerbaijan | Organic, Adwords, Keywords | google.az |
| bh | Bahrain | Organic, Adwords, Keywords | google.com.bh |
| bd | Bangladesh | Organic, Adwords, Keywords | google.com.bd |
| by | Belarus | Organic, Adwords, Keywords | google.by |
| bz | Belize | Organic, Adwords, Keywords | google.com.bz |
| bo | Bolivia | Organic, Adwords, Keywords | google.com.bo |
| ba | Bosnia and Herzegovina | Organic, Adwords, Keywords | google.ba |
| bw | Botswana | Organic, Adwords, Keywords | google.co.bw |
| bn | Brunei | Organic, Adwords, Keywords | google.com.bn |
| bg | Bulgaria | Organic, Adwords, Keywords | google.bg |
| cv | Cabo Verde | Organic, Adwords, Keywords | google.cv |
| kh | Cambodia | Organic, Adwords, Keywords | google.com.kh |
| cm | Cameroon | Organic, Adwords, Keywords | google.cm |
| cl | Chile | Organic, Adwords, PLA, Keywords | google.cl |
| co | Colombia | Organic, Adwords, PLA, Keywords | google.com.co |
| cr | Costa Rica | Organic, Adwords, Keywords | google.co.cr |
| hr | Croatia | Organic, Adwords, Keywords | google.hr |
| cy | Cyprus | Organic, Adwords, Keywords | google.com.cy |
| cz | Czech Republic | Organic, Adwords, PLA, Keywords | google.cz |
| cd | Congo | Organic, Adwords, Keywords | google.cd |
| do | Dominican Republic | Organic, Adwords, Keywords | google.com.do |
| ec | Ecuador | Organic, Adwords, Keywords | google.com.ec |
| eg | Egypt | Organic, Adwords, Keywords | google.com.eg |
| sv | El Salvador | Organic, Adwords, Keywords | google.com.sv |
| ee | Estonia | Organic, Adwords, Keywords | google.ee |
| et | Ethiopia | Organic, Adwords, Keywords | google.com.et |
| ge | Georgia | Organic, Adwords, Keywords | google.ge |
| gh | Ghana | Organic, Adwords, Keywords | google.com.gh |
| gr | Greece | Organic, Adwords, Keywords | google.gr |
| gt | Guatemala | Organic, Adwords, Keywords | google.com.gt |
| gy | Guyana | Organic, Adwords, Keywords | google.gy |
| ht | Haiti | Organic, Adwords, Keywords | google.ht |
| hn | Honduras | Organic, Adwords, Keywords | google.hn |
| is | Iceland | Organic, Adwords, Keywords | google.is |
| id | Indonesia | Organic, Adwords, PLA, Keywords | google.co.id |
| jm | Jamaica | Organic, Adwords, Keywords | google.com.jm |
| jo | Jordan | Organic, Adwords, Keywords | google.jo |
| kz | Kazakhstan | Organic, Adwords, Keywords | google.kz |
| kw | Kuwait | Organic, Adwords, Keywords | google.com.kw |
| lv | Latvia | Organic, Adwords, Keywords | google.lv |
| lb | Lebanon | Organic, Adwords, Keywords | google.com.lb |
| lt | Lithuania | Organic, Adwords, Keywords | google.lt |
| lu | Luxembourg | Organic, Adwords, Keywords | google.lu |
| mg | Madagascar | Organic, Adwords, Keywords | google.mg |
| my | Malaysia | Organic, Adwords, PLA, Keywords | google.com.my |
| mt | Malta | Organic, Adwords, Keywords | google.com.mt |
| mu | Mauritius | Organic, Adwords, Keywords | google.mu |
| md | Moldova | Organic, Adwords, Keywords | google.md |
| mn | Mongolia | Organic, Adwords, Keywords | google.mn |
| me | Montenegro | Organic, Adwords, Keywords | google.me |
| ma | Morocco | Organic, Adwords, Keywords | google.co.ma |
| mz | Mozambique | Organic, Adwords, Keywords | google.co.mz |
| na | Namibia | Organic, Adwords, Keywords | google.com.na |
| np | Nepal | Organic, Adwords, Keywords | google.com.np |
| nz | New Zealand | Organic, Adwords, PLA, Keywords | google.co.nz |
| ni | Nicaragua | Organic, Adwords, Keywords | google.com.ni |
| ng | Nigeria | Organic, Adwords, Keywords | google.com.ng |
| om | Oman | Organic, Adwords, Keywords | google.com.om |
| py | Paraguay | Organic, Adwords, Keywords | google.com.py |
| pe | Peru | Organic, Adwords, Keywords | google.com.pe |
| ph | Philippines | Organic, Adwords, PLA, Keywords | google.com.ph |
| pt | Portugal | Organic, Adwords, PLA, Keywords | google.pt |
| ro | Romania | Organic, Adwords, Keywords | google.ro |
| sa | Saudi Arabia | Organic, Adwords, Keywords | google.com.sa |
| sn | Senegal | Organic, Adwords, Keywords | google.sn |
| rs | Serbia | Organic, Adwords, Keywords | google.rs |
| sk | Slovakia | Organic, Adwords, Keywords | google.sk |
| si | Slovenia | Organic, Adwords, Keywords | google.si |
| za | South Africa | Organic, Adwords, PLA, Keywords | google.co.za |
| kr | South Korea | Organic, Adwords, Keywords | google.co.kr |
| lk | Sri Lanka | Organic, Adwords, Keywords | google.lk |
| th | Thailand | Organic, Adwords, Keywords | google.co.th |
| bs | Bahamas | Organic, Adwords, Keywords | google.bs |
| tt | Trinidad and Tobago | Organic, Adwords, Keywords | google.tt |
| tn | Tunisia | Organic, Adwords, Keywords | google.tn |
| ua | Ukraine | Organic, Adwords, Keywords | google.com.ua |
| ae | United Arab Emirates | Organic, Adwords, PLA, Keywords | google.ae |
| uy | Uruguay | Organic, Adwords, Keywords | google.com.uy |
| ve | Venezuela | Organic, Adwords, Keywords | google.co.ve |
| vn | Vietnam | Organic, Adwords, Keywords | google.com.vn |
| zm | Zambia | Organic, Adwords, Keywords | google.co.zm |
| zw | Zimbabwe | Organic, Adwords, Keywords | google.co.zw |
| ly | Libya | Organic, Adwords, Keywords | google.com.ly |
| mobile-us | United States | Organic, Adwords | google.com |
| mobile-uk | United Kingdom | Organic, Adwords | google.com |
| mobile-ca | Canada | Organic, Adwords | google.ca |
| mobile-de | Germany | Organic, Adwords | google.de |
| mobile-fr | France | Organic, Adwords | google.fr |
| mobile-es | Spain | Organic, Adwords | google.es |
| mobile-it | Italy | Organic, Adwords | google.it |
| mobile-br | Brazil | Organic, Adwords | google.com.br |
| mobile-au | Australia | Organic, Adwords | google.com.au |
| mobile-dk | Denmark | Organic, Adwords | google.dk |
| mobile-mx | Mexico | Organic, Adwords | google.com.mx |
| mobile-nl | Netherlands | Organic, Adwords | google.nl |
| mobile-se | Sweden | Organic, Adwords | google.se |
| mobile-tr | Turkey | Organic, Adwords | google.com.tr |
| mobile-in | India | Organic, Adwords | google.co.in |
| mobile-id | Indonesia | Organic, Adwords | google.co.id |
| mobile-il | Israel | Organic, Adwords | google.co.il |
| il-ext | Israel Ext | Organic, Adwords | google.co.il-ext |
| tr-ext | Turkey Ext | Organic, Adwords, PLA | google.co.tr-ext |
| dk-ext | Denmark Ext | Organic, Adwords | google.dk-ext |
| no-ext | Norway Ext | Organic, Adwords | google.no-ext |
| se-ext | Sweden Ext | Organic, Adwords | google.se-ext |
| fi-ext | Finland Ext | Organic, Adwords | google.fi-ext |
| ch-ext | Switzerland Ext | Organic, Adwords, PLA | google.ch-ext |
| mobile-il-ext | Israel Ext | Organic, Adwords | google.co.il-ext |
| pa | Panama | Organic, Adwords, Keywords | google.com.pa |
| pk | Pakistan | Organic, Adwords, Keywords | google.com.pk |
| tw | Taiwan | Organic, Adwords, Keywords | google.com.tw |
| qa | Qatar | Organic, Adwords, Keywords | google.com.qa |
Show all
Error messages
| Name | Description | |
|---|---|---|
| ERROR 50 :: NOTHING FOUND | We haven't found any information related to your request. | |
| ERROR 40 :: MANDATORY PARAMETER action NOT SET OR EMPTY | The required parameter action is missing or has been mistyped. Please add it to your request, or check the spelling. | |
| ERROR 41 :: MANDATORY PARAMETER type NOT SET OR EMPTY | The required parameter type is missing or has been mistyped. Please add it to your request, or check the spelling. | |
| ERROR 42 :: MANDATORY PARAMETER domain NOT SET OR EMPTY | The required parameter domain is missing, or its value is not set. Please add it to your request, or set its value. | |
| ERROR 43 :: MANDATORY PARAMETER phrase NOT SET OR EMPTY | The required parameter phrase is missing, or its value is not set. Please add it to your request, or set its value. | |
| ERROR 44 :: MANDATORY PARAMETER url NOT SET OR EMPTY | The required parameter url is missing, or its value is not set. Please add it to your request, or set its value. | |
| ERROR 46 :: MANDATORY PARAMETER database NOT SET OR EMPTY | The required parameter database is missing, or its value is not set. Please add it to your request, or set its value. | |
| ERROR 120 :: WRONG KEY - ID PAIR | You tried to use an unknown API key. Please go to your profile to find your correct API key. | |
| ERROR 130 :: API DISABLED | [#api.error_130#] | |
| ERROR 131 :: LIMIT EXCEEDED | The API request limit for the requested report has been reached. (Valid for users of old API plans.) | |
| ERROR 132 :: API UNITS BALANCE IS ZERO | The API request limit has been reached. To continue using API, recharge your balance, or upgrade your subscription. | |
| ERROR 133 :: DB ACCESS DENIED | You are not allowed to access the requested database. | |
| ERROR 134 :: TOTAL LIMIT EXCEEDED | The API request limit has been reached. (Valid for users of old API plans.) | |
| ERROR 135 :: API REPORT TYPE DISABLED | You are not allowed to access the requested report. | |
| ERROR 10000 :: Wrong parameter '{parameter}'. {description}. | Invalid parameter value. Please specify the value according to the description. | |
| ERROR 10001 :: Wrong parameter '{parameter}'. {description}. | A parameter is duplicated. | |
| ERROR 10010 :: Wrong parameter '{parameter}'. {description}. | Invalid parameter value. Please specify the value according to the description. | |
| ERROR 10011 :: Wrong parameter '{parameter}'. {description}. | Parameter value is out of range. Please specify the value according to the description. | |
| ERROR 10012 :: Wrong parameter '{parameter}'. {description}. | Parameter value is out of range. Please specify the value according to the description. | |
| ERROR 10013 :: Wrong parameter '{parameter}'. {description}. | Required parameter is not specified. | |
| ERROR 10014 :: Wrong parameter '{parameter}'. {description}. | Parameter has duplicated values. | |
| ERROR 10030 :: Wrong parameter '{parameter}'. {description}. | Parameter has too many values. | |
| ERROR 10031 :: Wrong parameter '{parameter}'. {description}. | Parameter does not have enough values. | |
| ERROR 10040 :: Wrong parameter '{parameter}'. {description}. | Parameter 'selected_targets' must not contain more domains than the 'excludes' segment. | |
| ERROR 10041 :: Wrong parameter '{parameter}'. {description}. | Not all the 'selected_targets' domains are specified in the 'targets' parameter. | |
| ERROR 10042 :: Wrong parameter '{parameter}'. {description}. | Invalid parameter value. The value is not a domain. | |
| ERROR 10043 :: Wrong parameter '{parameter}'. {description}. | Invalid parameter value. Please specify the first day of the month. |
Show all
Filters
To apply a filter to a report, must add the display_filter parameter with a URL-encoded string that contains filters separated by | (maximum number: 25).
Some ready-to-use functions might code the + sign incorrectly. Make sure that it's followed by these symbols: %2B.
A filter consists of <sign>|<field>|<operation>|<value>, where:
<sign>: + or - (include/exclude).
<field>: Possible fields: Co, Cp, Db, Hs, Wc, Nq, Nr, P0, P1, P2, P3, P4, Ph, Po, Pp, Qu, Rt, Tc, Tr, Ts, Ur, Vu, ad, title, text, url.
Metrical fields
| Value | Description |
|---|---|
| Co | Competitive density of advertisers using the given term for their ads. One (1) means the highest competition. |
| Cp | Average price in US dollars advertisers pay for a user's click on an ad containing a particular keyword (Google Ads). |
| Db | Regional database (US, UK, Italy, etc.) |
| Hs | This columns shows whether or not a report's line returns historical data. |
| Wc | Word Count. Allows to filter the results for keywords with certain number of terms in them. For example, "more than 3 words, but less than 5." |
| Nq | The average number of times users have searched for a given keyword per month. We calculate this value over the last 12 months. |
| Nr | The total number of organic results returned for a given keyword on the last date of data gathering. |
| P0 | A position of the first queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| P1 | A position of the second queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| P2 | A position of the third queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| P3 | A position of the fourth queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| P4 | A position of the fifth queried domain for a particular keyword in Google's top 100 organic or paid search results. |
| Ph | Keyword bringing users to the website via Google's top 100 organic search results. You can enter multiple keywords by separating them with a comma. A comma is treated as an OR operator. Max. 300 characters. |
| Po | Position a URL gets with a particular keyword in Google's top 100 organic or paid search results. |
| Pp | The position of the Ad at the time of previous data gathering. |
| Pr | Price of promoted product. |
| Qu | Query. |
| Rt | Report type. |
| Tc | The percentage of the domain's total traffic cost that is attributed to a particular keyword. |
| Tr | The share of traffic driven to the website by a particular keyword for a specified period. |
| Ts | UNIX Timestamp. |
| Tt | The title of a product listing ad that represents the name of a promoted product. |
| Ur | The URL of the target page (Backlinks). |
| Vu | Visible URL. |
| In | Filter by keyword intent. Possible values: 0 (Commercial), 1 (Informational), 2 (Navigational), 3 (Transactional). |
| Ipu | Number of positions with unknown intent. |
| Ip0 | Number of positions with the Commercial intent. |
| Ip1 | Number of positions with the Informational intent. |
| Ip2 | Number of positions with the Navigational intent. |
| Ip3 | Number of positions with the Transactional intent. |
Show all
Textual fields
| Value | Description | |
|---|---|---|
| Ph | The keyword bringing users to the URL via Google's top 100 organic search results. | |
| Qu | Query. | |
| Rt | Report type. | |
| Ur | The URL displayed in search results for the given keyword. | |
| Vu | Display URL. This is the URL displayed on the Ad, identifying the site for users. | |
| title | The title of a text ad. | |
| text | The text of a text ad. | |
| ad | The concatenated title, text and visible URL of a text ad. | |
| url | The visible URL, or the target URL, or the domain name. |
Show all
Fields with fixed values
| Value | Description | |
|---|---|---|
| Db | Regional database (US, UK, Italy, etc.). Possible values: 'us', 'uk', 'mobile-uk', 'ca', 'mobile-ca', 'ru', 'de', 'mobile-de', 'fr', 'mobile-fr', 'es', 'mobile-es', 'it', 'mobile-it', 'br', 'mobile-br', 'au', 'mobile-au', 'bing-us', 'ar', 'be', 'ch', 'dk', 'mobile-dk', 'fi', 'hk', 'ie', 'il', 'mobile-il', 'mx', 'mobile-mx', 'nl', 'mobile-nl', 'no', 'pl', 'se', 'mobile-se', 'sg', 'tr', 'mobile-tr', 'jp', 'in', 'mobile-in', 'hu', 'mobile-us'. | |
| Hs | Whether or not a report's line returns historical data. Possible values: '0', '1'. | |
| type | Backlink type. Possible values: 'nofollow', 'frame', 'form', 'image'. | |
| zone | Backlink TLD zone | |
| Br |
Branded keywords. Possible values:'0', '1', '3'. '0': Not Branded '1': Branded for other domain '3': Branded |
Show all
<operation>: Possible operations: Eq, Gt, Lt, Bw, Ew, Co, Wm.
For metrical fields
| Value | Description | |
|---|---|---|
| Eq | Equals | |
| Gt | Greater than | |
| Lt | Less than |
For textual fields
| Value | Description | |
|---|---|---|
| Bw | Starts with | |
| Ew | Ends with | |
| Eq | Exactly matching | |
| Co | Containing | |
| Wm | Word matching |
Show all
For fields with fixed values.
Leave the field blank.
SERP Features
| Code | Name | Linking to domain | Description |
|---|---|---|---|
| 0 | Instant answer | No | A direct answer to a user's search query that is usually displayed at the top of organic search results in the form of a gray-bordered box. |
| 1 | Knowledge panel | Yes | A block with brief information related to a searched topic that appears to the right of organic search results. |
| 2 | Carousel | No | A row of horizontally scrollable images displayed at the top of search results. |
| 3 | Local pack | Yes | A map with three local results that appears at the top of organic search results for a local search query. |
| 4 | Top stories | Yes | A card-style snippet presenting up to three news-related results relevant to user's search query, which is usually displayed between organic search results. |
| 5 | Image pack | Yes | A collection of images related to a search query that is usually displayed between organic search results. |
| 6 | Sitelinks | Yes | A set of links to other pages of a website that is displayed under the main organic search result and for brand-related search queries. |
| 7 | Reviews | Yes | Organic search results marked with star ratings and including the number of reviews the star rating is based on. |
| 8 | Tweet | No | A card-style snippet displaying the most recent tweets related to a search query. |
| 9 | Video | Yes | Video results with a thumbnail displayed along with other organic search results. |
| 10 | Featured video | Yes | A video result to a search query that is displayed at the top of all organic search results. |
| 11 | Featured Snippet | Yes | A short answer to a user's search query with a link to the third-party website it is taken from that appears at the top of all organic search results. |
| 13 | Image | Yes | An image result with a thumbnail displayed along with other organic search results. |
| 14 | Ads top | No | A series of ads (up to 4) that appear at the top of the first search results page. |
| 15 | Ads bottom | No | A series of ads (up to 4) that appear at the bottom of the first search results page. |
| 16 | Shopping ads | No | A row of horizontally scrollable paid shopping results that appear at the top of a search results page for a brand or product search query, and include the website's name, pricing, and product image. |
| 17 | Hotels Pack | No | A block that displays hotels related to a search query. Hotel results include information on prices and rating, and allows users to check availability for certain dates. |
| 18 | Jobs search | No | A number of job listings related to a search query that appear at the top of the search results page. Job listings include the job title, the company offering the job, a site where the listing was posted, etc. |
| 19 | Featured images | No | A collection of images is usually displayed at the top of the SERP if Google considers visual results to be more relevant than text results. Only for mobile devices. |
| 20 | Video Carousel | Yes | A row of horizontally scrollable videos displayed among search results. |
| 21 | People also ask | Yes | A series of questions that may relate to a search query that appears in an expandable grid box labeled "People also ask" between search results. |
| 22 | FAQ | Yes | A list of questions related to a particular search that shows up for a particular organic search result. When clicked on, each of the questions reveals the answer. |
| 23 | Flights | No | A block that displays flights related to a search query. Flight results include information on flight dates, duration, the number of transfers and prices. Data is taken from Google Flights. |
| 24 | Find results on | Yes | A block of domains displayed above a map. |
| 25 | Recipes | Yes | A block of recipes displayed at the top of the search results page. |
| 27 | Twitter сarousel | Yes | A carousel of tweets displayed among organic search results. |
| 28 | Indented | Yes | A list of related pages from the highest organic search result. |
| 29 | News | Yes | A list of trending news displayed among organic search results. |
| 30 | Address Pack | No | A map with the most popular places displayed at the top of the search results page. |
| 31 | Application | Yes | An app from the App Store or Play Store displayed among organic search results. Only on mobile devices. |
| 32 | Events | No | A list of relevant events displayed at the top of organic search results. |
| 34 | Popular products | No | A carousel of reviewed products available for purchasing. |
| 35 | Related products | No | A carousel of related products available for purchasing. |
| 36 | Related searches | No | A list of related searches displayed among organic search results. |
| 37 | See results about | No | A list of more precise queries displayed on the right of the search results page. |
| 38 | Short videos | Yes | A block of vertical videos. Only on mobile devices. |
| 39 | Web stories | Yes | A block of vertical stories. Only on mobile devices. |
| 40 | Application list | Yes |
A list of apps displayed among organic search results. Only on mobile devices. |
Show all
Sortings
| Name | Description | |
|---|---|---|
| am_asc | sorting by changes in paid keywords in ascending order (Am) | |
| am_desc | sorting by changes in paid keywords in descending order (Am) | |
| bm_asc | sorting by changes in paid traffic in ascending order (Bm) | |
| bm_desc | sorting by changes in paid traffic in descending order (Bm) | |
| cg_asc | sorting by traffic cost in ascending order (Cg) | |
| cg_desc | sorting by traffic cost in descending order (Cg) | |
| cm_asc | sorting by changes in ads traffic price in ascending order (Cm) | |
| cm_desc | sorting by changes in ads traffic price in descending order (Cm) | |
| co_asc | sorting by competition in ascending order (Co) | |
| co_desc | sorting by competition in descending order (Co) | |
| cp_asc | sorting by CPC in ascending order (Cp) | |
| cp_desc | sorting by CPC in descending order (Cp) | |
| cr_asc | sorting by competition level in ascending order (Cr) | |
| cr_desc | sorting by competition level in descending order (Cr) | |
| cv_asc | sorting by coverage in ascending order (Cv) | |
| cv_desc | sorting by coverage in descending order (Cv) | |
| dt_asc | sorting by the date of the last update in ascending order (Ts) | |
| dt_desc | sorting by the date of the last update in descending order (Ts) | |
| kd_asc | sorting by keyword difficulty in ascending order (Kd) | |
| kd_desc | sorting by keyword difficulty in descending order (Kd) | |
| np_asc | sorting by common keywords in ascending order (Np) | |
| np_desc | sorting by common keywords in descending order (Np) | |
| nq_asc | sorting by volume in ascending order (Nq) | |
| nq_desc | sorting by volume in descending order (Nq) | |
| nr_asc | sorting by the number of results in ascending order (Nr) | |
| nr_desc | sorting by the number of results in descending order (Nr) | |
| om_asc | sorting by changes in organic keywords in ascending order (Om) | |
| om_desc | sorting by changes in organic keywords in descending order (Om) | |
| p0_asc | sorting by a position of the 1st domain in ascending order (P0) | |
| p0_desc | sorting by a position of the 1st domain in descending order (P0) | |
| p1_asc | sorting by a position of the 2nd domain in ascending order (P1) | |
| p1_desc | sorting by a position of the 2nd domain in descending order (P1) | |
| p2_asc | sorting by a position of the 3rd domain in ascending order (P2) | |
| p2_desc | sorting by a position of the 3rd domain in descending order (P2) | |
| p3_asc | sorting by a position of the 4th domain in ascending order (P3) | |
| p3_desc | sorting by a position of the 4th domain in descending order (P3) | |
| p4_asc | sorting by a position of the 5th domain in ascending order (P4) | |
| p4_desc | sorting by a position of the 5th domain in descending order (P4) | |
| pc_asc | sorting by number of keywords in ascending order (Pc) | |
| pc_desc | sorting by number of keywords in descending order (Pc) | |
| po_asc | sorting by a position in ascending order (Po) | |
| po_desc | sorting by a position in descending order (Po) | |
| pr_asc | sorting by price in ascending order (Pr) | |
| pr_desc | sorting by price in descending order (Pr) | |
| scm_asc | sorting by changes in the organic traffic cost driven by SERP Feature positions in ascending order (Scm) | |
| scm_desc | sorting by changes in the organic traffic cost driven by SERP Feature positions in descending order (Scm) | |
| srm_asc | sorting by changes in the number of keywords with SERP Feature positions in ascending order (Srm) | |
| srm_desc | sorting by changes in the number of keywords with SERP Feature positions in descending order (Srm) | |
| stm_asc | sorting by changes in the traffic driven by SERP Feature postions in ascending order (Stm) | |
| stm_desc | sorting by changes in the traffic driven by SERP Feature postions in descending order (Stm) | |
| tc_asc | sorting by traffic cost share in ascending order (Tc) | |
| tc_desc | sorting by traffic cost share in descending order (Tc) | |
| tg_asc | sorting by traffic in ascending order (Tg) | |
| tg_desc | sorting by traffic in descending order (Tg) | |
| tm_asc | sorting by changes in organic traffic in ascending order (Tm) | |
| tm_desc | sorting by changes in organic traffic in descending order (Tm) | |
| tr_asc | sorting by traffic share in ascending order (Tr) | |
| tr_desc | sorting by traffic share in descending order (Tr) | |
| ts_asc | sorting by timestamp in descending order (Ts) | |
| ts_desc | sorting by timestamp in descending order (Ts) | |
| um_asc | sorting by changes in organic traffic price in ascending order (Um) | |
| um_desc | sorting by changes in organic traffic price in descending order (Um) | |
| last_seen_asc | sorting by the last-seen date in ascending order (last_seen) | |
| last_seen_desc | sorting by the last-seen date in descending order (last_seen) | |
| first_seen_asc | sorting by the first-seen date in ascending order (first_seen) | |
| first_seen_desc | sorting by the first-seen date in descending order (first_seen) | |
| times_seen_asc | sorting by the number of times seen in ascending order (times_seen) | |
| times_seen_desc | sorting by the number of times seen in descending order (times_seen) | |
| ads_count_asc | sorting by the number of display ads in ascending order (ads_count) | |
| ads_count_desc | sorting by the number of display ads in descending order (ads_count) |
Show all