contacts

Telephone

United States

dropdown button

United States

Canada

United Kingdom

Spain

France

Italy

Germany

Australia

+1 (800) 815 - 9959

10:00 AM - 5:00 PM (EST/EDT)

Monday - Friday

mobile-menu

Basic docs

Analytics divider Last updated: September 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

Authentication

Request authentication is provided via API keys. An API key is assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units. If your API key is unavailable there, refer to How to get API documentation.

Never share your API key publicly. If you share an API call example, replace your key with a placeholder such as https://api.semrush.com/?key=<key>.

Your API key also gives access to your API unit balance. Exposing your credentials can result in your account being compromised, which could lead 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 Ads).
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 Current date.
Fk All SERP Features triggered by a keyword. For a full list of available features, refer to the SERP Features section.
Fp SERP features in which a domain appears on SERP for a keyword. For a full list of available features, refer to the SERP Features section.
Fl (Deprecated) SERP features in which a domain appears on SERP for a keyword.
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 Ads.
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..X9,XA, 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
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

Regional database types:

  • Desktop: Specified as a two-letter code.
  • Mobile: Specified as a two-letter code with the mobile- prefix.
  • Extended: Specified as a two-letter code with the -ext suffix.
Mobile and extended databases aren't available for any requests in the Keyword reports.
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 Recommended action
ERROR 40 :: MANDATORY PARAMETER action NOT SET OR EMPTY The required 'action' parameter is missing, or its value is not set. Add the parameter to your request or set its value.
ERROR 41 :: MANDATORY PARAMETER type NOT SET OR EMPTY The required 'type' parameter is missing, or its value is not set. Add the parameter to your request or set its value.
ERROR 42 :: MANDATORY PARAMETER domain NOT SET OR EMPTY The required 'domain' parameter is missing, or its value is not set. Add the parameter to your request or set its value.
ERROR 43 :: MANDATORY PARAMETER phrase NOT SET OR EMPTY The required 'phrase' parameter is missing, or its value is not set. Add the parameter to your request or set its value.
ERROR 44 :: MANDATORY PARAMETER url NOT SET OR EMPTY The required 'url' parameter is missing, or its value is not set. Add the parameter to your request or set its value.
ERROR 46 :: MANDATORY PARAMETER database NOT SET OR EMPTY The required 'database' parameter is missing, or its value is not set. Add the parameter to your request or set its value.
ERROR 48 :: REQUEST METHOD NOT ALLOWED, USE GET Invalid request method. Use the HTTP GET method.
ERROR 50 :: NOTHING FOUND No information related to your request was found. Double-check the request parameters. If they are correct but yield no results, contact the Semrush Support Team and provide them with your API request.
ERROR 110 :: INVALID IMPORT KEY The API key has an incorrect format. Go to the Subscription info section to find the correct API key.
ERROR 120 :: WRONG KEY - ID PAIR You tried to use an unknown API key. Go to the Subscription info section to find the correct API key.
ERROR 130 :: API DISABLED Your subscription doesn't let you use API. Upgrade your subscription plan to get access to the API.
ERROR 131 :: LIMIT EXCEEDED The API request limit for the requested report has been reached. Contact the Semrush Support Team.
ERROR 132 :: API UNITS BALANCE IS ZERO The API unit limit has been reached. You have used all your API units. To continue using the API, recharge your balance or upgrade your subscription.
ERROR 133 :: DB ACCESS DENIED You are not allowed to access the requested database. Contact the Semrush Sales Team to get access to more databases.
ERROR 134 :: TOTAL LIMIT EXCEEDED The total API request limit has been reached. Contact the Semrush Support Team.
ERROR 135 :: API REPORT TYPE DISABLED 1. The report you're trying to access is no longer available. 2. The subscription has ended. 1. Check if there's another report that suits your needs or contact the Semrush Support Team.
2. Update your subscription or contact the Semrush Support Team.
ERROR 136 :: Multiple limits not allowed Internal limit error. Contact the Semrush Support Team.
ERROR 402 :: Request param not valid The API key is incorrect. Go to the Subscription info section to find the correct API key.
ERROR 402 :: Request param not valid :: Duplicate domains The 'targets' parameter contains duplicated values. Remove the duplicated values from the 'targets' parameter.
ERROR 404 :: Not found Internal error. User information wasn't found in the Semrush database. Contact the Semrush Support Team.
ERROR 500 :: Internal Error Internal error. Try again later or contact the Semrush Support Team.
ERROR 10000 :: Wrong parameter '{parameter}'. {description}. Invalid parameter value. Specify the value according to the description.
ERROR 10001 :: Wrong parameter '{parameter}'. {description}. The parameter is duplicated. Remove the duplicated parameter from your request.
ERROR 10010 :: Wrong parameter '{parameter}'. {description}. The parameter value is out of range. Specify the value according to the description.
ERROR 10011 :: Wrong parameter '{parameter}'. {description}. The parameter value is less than the minimum value. Specify the value according to the description.
ERROR 10012 :: Wrong parameter '{parameter}'. {description}. The parameter value is greater than the maximum value. Specify the value according to the description.
ERROR 10013 :: Wrong parameter '{parameter}'. {description}. The required parameter is not specified. Specify the required parameter.
ERROR 10014 :: Wrong parameter '{parameter}'. {description}. The parameter has duplicated values. Check the request and remove duplicate parameter values.
ERROR 10015 :: Wrong parameter '{parameter}'. {description}. The parameter can't be used with other request parameter values. Specify the parameters or values according to the description.
ERROR 10030 :: Wrong parameter '{parameter}'. {description}. The parameter has too many values. Check the request and reduce the number of values according to the description.
ERROR 10031 :: Wrong parameter '{parameter}'. {description}. The parameter doesn't have enough values. Check the request and the missing values according to the description.
ERROR 10040 :: Wrong parameter '{parameter}'. {description}. The 'selected_targets' parameter mustn't contain more domains than 'targets' with the segment equal to 'excludes'. Ensure 'selected_targets' aligns with the 'excludes' segment limit and adjust domains accordingly.
ERROR 10041 :: Wrong parameter '{parameter}'. {description}. Not all the 'selected_targets' domains are specified in the 'targets' parameter. In 'selected_targets', specify only those domains that are indicated in the 'targets' parameter.
ERROR 10042 :: Wrong parameter '{parameter}'. {description}. Invalid parameter value. The value is not a domain. Specify the domain.
ERROR 10043 :: Wrong parameter '{parameter}'. {description}. Invalid parameter value. Specify the first day of the month.
ERROR 10044 :: Wrong parameter '{parameter}'. {description}. Invalid parameter value. Specify the value according to the description.
ERROR 10045 :: Wrong parameter '{parameter}'. {description}. Invalid parameter value. Specify the value according to the description.
Show all

Filters

To apply filters to a report, add the display_filter parameter with a URL-encoded string that contains filters separated by | (%7C). Max. number of filters that can be applied at once is 25.

A single filter consists of <sign>|<field>|<operation>|<value>, where:

  • <sign>: + (%2B) or - (%2D) to include or exclude the corresponding data.
  • <field>: Possible fields are listed in the tables in the upcoming sections.
  • <operation>: Possible operations are listed in the Operations section and depend on the field type.
  • <value>: Possible values depend on the field.
Some ready-to-use functions might encode the + sign incorrectly. Make sure that it's encoded as %2B.

Example requests

Find keywords related to the target phrase with a search volume of less than 1000 (1 filter)

https://api.semrush.com/?type=phrase_related&key=YOUR_API_KEY&phrase=seo&export_columns=Ph,Nq,Cp,Co,Nr,Td,Rr,Fk&database=us&display_limit=10&display_sort=nq_desc&display_filter=%2B%7CNq%7CLt%7C1000

Find organic keywords with the transactional intent (1st filter) for which the target domain ranks below 5th position (2nd filter)

https://api.semrush.com/?type=domain_organic&key=YOUR_API_KEY&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,In,Pp&domain=toyota.com&display_sort=tr_desc&database=us&display_filter=%2B%7CIn%7CEq%7C3%7C%2B%7CPp%7CGt%7C5

Metric fields

Value Description
Co Competitive density of advertisers using the given term for their ads. One (1) indicates the highest competition.
Cp Average price in USD that advertisers pay for a user's click on an ad containing a particular keyword (Google Ads).
Db Regional database (US, UK, Italy, etc.).
Hs 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 Average number of times users have searched for a given keyword per month. Semrush calculates this value over the last 12 months.
Nr Total number of organic results returned for a given keyword on the last date of data gathering.
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.
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 is in for a particular keyword in Google's top 100 organic or paid search results.
Pp Position of the Ad at the time of previous data gathering.
Pr Price of promoted product.
Qu Query.
Rt Report type.
Tc Percentage of the domain's total traffic cost that is attributed to a particular keyword.
Tr Share of traffic driven to the website by a particular keyword for a specified period.
Ts UNIX Timestamp.
Tt Title of a product listing ad (PLA) that represents the name of a promoted product.
Ur 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

Text fields

Value Description
Ph Keyword bringing users to the URL via Google's top 100 organic search results.
Qu Query.
Rt Report type.
Ur 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 Title of a text ad.
text Text of a text ad.
ad Concatenated title, text and visible URL of a text ad.
url Visible URL, target URL, or 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

Operations

<operation> can be set depending on the field type.

For metric fields

Value Description
Eq Equals
Gt Greater than
Lt Less than

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

The table provides a list of supported SERP features with their codes and descriptions and indicates whether a particular SERP feature includes a direct link to the target domain.

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.
12 AMP No Pages that are more mobile-friendly. Google doesn't distinguish them from other 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 that appear at the top of the first search results page.
15 Ads bottom No A series of ads 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.
26 Related Topics No A block that contains a list of topics related to the search query.
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.
41 Buying guide Yes A block of questions about the product's features.
42 Organic carousel Yes A carousel with organic results at the top of the SERP.
43 Things to know Yes A block of the most common related questions.
44 Datasets Yes A list of scientific datasets.
45 Discussions and forums Yes A block of related discussions.
46 Explore brands Yes A list of related brands.
47 Questions and answers Yes A carousel of related questions and answers.
48 Popular stores Yes A list of popular related stores.
49 Refine No A block of related search queries with clarifying keywords.
50 People also search No A carousel of competitor brands and companies at the bottom of the SERP.
51 Ads middle No A series of ads that appear in the middle of the first search results page.
52 AI overview Yes An answer generated by AI.
Show all

The SERP features codes can be included in the FKn and FPn columns (as listed in Columns table) when making requests to retrieve data on keyword-specific SERP features and their positions. These columns are used with the export_columns parameter; however, not all requests accept FKn and FPn as part of export_columns.

Example request

Retrieve ranking data for the domain, including keyword-specific SERP feature insights

https://api.semrush.com/?key=API_KEY&type=domain_ranks&export_columns=Db,Dn,Rk,Or,Ot,Oc,Ad,At,Ac,Sh,Sv,FK1,FP1&domain=apple.com&database=us

This example retrieves SERP feature data for your domain, where FP1 shows the count of times the domain ranks within a specific SERP feature (in this case, 1 is for Knowledge panel), and FK1 shows the total occurrences of this feature for keywords the domain ranks for, whether or not the domain appears in it.

Sortings

You can sort the response results by different parameters in ascending or descending order.

To set the sorting in an Analytics report request, include the display_sort parameter with the target sorting rule. You can set only one sorting rule per request.

For example, you can sort keywords by traffic share in descending order in the Domain Organic Search Keywords request:

Set the display_sort request parameter to tr_desc

https://api.semrush.com/?type=domain_organic&key=YOUR_API_KEY&display_filter=%2B%7CPh%7CCo%7Cseo&display_limit=10&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td&domain=seobook.com&display_sort=tr_desc&database=us

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