Basic docs

Analytics

Last updated: August 18, 2021

It’s a group of products with Analytics reports including:

Domain Analytics
Organic Research
Advertising Research
Keyword Gap Analysis
Keyword Analytics
Backlink Analytics

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:

Column names can't be changed
The order of columns can be changed
The number of columns can be increased
Semrush will only remove old columns after notifying users

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.

Show all

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

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

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.

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 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

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	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

Show all

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.

Show all

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

Basic docs

About

Auth

Columns

Databases

Error messages

Filters

SERP Features

Sortings