Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Need help?
Telephone
United States
United States
Canada
United Kingdom
Spain
France
Italy
Germany
Australia
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
It’s a group of products with Analytics reports including:
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.
Tips and tricks:
Name | Description |
---|---|
Ab | The place on a SERP where an ad appeared (top, side, or bottom blocks). |
Ac | Estimated budget spent buying keywords in Google AdWords for ads that appear in paid search results (monthly estimation). |
Ad | Keywords a website is buying in Google AdWords 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 | The 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 US dollars 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 | The 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 | The 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 | This columns shows 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 | The total number of positions with unknown intent. |
Ip0 | The total number of positions with the Commercial intent. |
Ip1 | The total number of positions with the Informational intent. |
Ip2 | The total number of positions with the Navigational intent. |
Ip3 | The total number of positions with the Transactional intent. |
Itu | The total amount of traffic with unknown intent. |
It0 | The total amount of traffic with the Commercial intent. |
It1 | The total amount of traffic with the Informational intent. |
It2 | The total amount of traffic with the Navigational intent. |
It3 | The total amount of traffic with the Transactional intent. |
Icu | The total cost of traffic with unknown intent. |
Ic0 | The total cost of traffic with the Commercial intent. |
Ic1 | The total cost of traffic with the Informational intent. |
Ic2 | The total cost of traffic with the Navigational intent. |
Ic3 | The total cost of traffic with the Transactional intent. |
Kd | An 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 | 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 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 a parameter display_offset 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. |
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-3 1: 4-10 2: 11-20 3: 21-30 4: 31-40 5: 41-50 6: 51-60 7: 61-70 8: 71-80 9: 81-90 a: 91-100+ |
Ot | Traffic brought to a website via Google's top 100 organic search results. |
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. |
Pc | Number of keywords. |
Pd | The 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 a URL gets with a particular keyword in Google's top 100 organic or paid search results. |
Pp | A position a domain gets with a particular keyword in Google's top 100 organic or paid search results. |
Pr | Price of promoted product |
Pt | The type of position (the regular organic position or the specific SERP Feature). |
Rh | The SEMrush rating of the website's popularity based on organic traffic coming from Google's top 100 organic search results. |
Rk | The SEMrush rating of the website's popularity based on organic traffic coming from Google's top 100 organic search results. |
Rr | This indicator reflects the degree of relevance of result keyword to the seed keyword. |
Rt | Report type |
Sc | The 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 | The amount of estimated organic traffic driven to an analyzed domain from a SERP Feature position over a specific period of time. |
Stb | The 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 | The percentage of the domain's total traffic cost that is attributed to a particular keyword. |
Tg | The amount of estimated organic traffic driven to an analyzed domain with a given keyword over a specific period of time. |
Td | The 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 | The 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 | The URL of the target page (Backlinks). |
Vu | Visible URL. |
ads_count | The total number of all types of display ads (media and text) during a specified period. |
ads_overall | The total number of all types of display ads (media and text) for all time. |
advertisers_count | The total number of advertisers on Google’s Display Network where a publisher promoted a website in the last 7 days. |
advertisers_overall | The total number of advertisers on Google’s Display Network where a publisher promoted a website. |
anchor | A clickable text of a backlink. |
avg_positions | An average position of an ad. |
domain | Domain name. |
domain_overall | The 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. |
external_num | The number of the source page’s links that point to other websites’ pages. |
first_seen | The timestamp on which SEMrush first noticed a backlink. |
image_alt | A URL of an image backlink's location. |
internal_num | The number of the source page’s links that point to webpages of the same website. |
last_seen | The timestamp on which SEMrush last noticed a backlink. |
media_ads_count | The total number of media display ads of an advertiser SEMrush has noticed during a specified period. |
media_ads_overall | The total number of an advertiser’s media display ads SEMrush has noticed for a whole period. |
media_type | The display ad’s type of media. |
publishers_count | The total number of publishers’ websites where display ads of an advertiser's website appeared in the last 7 days. |
publishers_overall | The total number of publishers’ websites where the display ads of an advertiser's website appeared during a whole period. |
redirect_url | The last URL in a redirect chain. |
response_code | Server response code. |
source_title | The title of the source page. |
source_size | The source page‘s size in bytes. |
source_url | The URL of the source page. |
target_title | The title of the target page. |
target_url | The URL of the target page (Backlinks). |
target_url | The landing page of a display ad (Display Advertising). |
text | The text of a display ad. |
text_ads_count | The total number of display ads during a specified period. |
text_ads_overall | The total number of display ads SEMrush noticed for a whole period. |
times_seen | The number of times SEMrush saw a display ad. |
title | The title of a display ad. |
type | The metrics indicates the backlink type |
visible_url | A visible URL of a display ad. |
ascore | Authority Score is our proprietary metric used to measure overall quality of domain/URL and influence on SEO. The score is based on the number of backlinks, referring domains, organic search traffic, and other data. |
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. |
page_ascore | Page Authority Score is our proprietary metric used to measure overall quality of URL and influence on SEO. The score is based on the number of backlinks, referring domains, organic search traffic, and other data. |
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” |
neighbour | A domain with a similar backlink profile to the analyzed domain. |
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. |
common_refdomains | The number of referring domains that link back to both the analyzed and competing domains. |
domains_num | The total number of domains, including common referring domains, linking to a given domain. |
backlinks_num | The number of backlinks to a given domain. |
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 |
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. |
To apply a filter to a report, you must add a parameter display_filter
with a URL-encoded string that contains filters separated by |
(maximum number: 25).
Please be aware that some ready-to-use functions might code the sign + incorrectly. Make sure that it is followed by the 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 AdWords). |
Db | Regional database (US, UK, Italy, etc.) |
Hs | This columns shows whether or not a report's line returns historical data. |
Wc | Word Count. Allow to filter the results for keywords with certain amounts of terms in them. Like, "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 at the last date of collection. |
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 collection |
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 with 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. |
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 your Ad, identifying your site for users | |
title | The title of a text ad | |
text | The title 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 |
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 | This columns shows whether or not a report's line returns historical data. (possible values: '0', '1') | |
type | The metrics indicates the backlink type (possible values: 'nofollow', 'frame', 'form', 'image') | |
zone | The metrics indicates the backlink TLD zone |
<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 |
For fields with fixed values
leave field blank
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. |
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) |