Semrush Developers

Price: 40 API units per request

This report provides a summary of backlinks, including their type, referring domains and IP addresses for a domain, root domain, or URL.

Request parameters

Name	Value/Type	Description
type*	backlinks_overview	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	ascore, total, domains_num, urls_num, i… ascore, total, domains_num, urls_num, ips_num, ipclassc_num, follows_num, nofollows_num, sponsored_num, ugc_num, texts_num, images_num, forms_num, frames_num	Required columns must be separated by commas.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_overview&target=searchenginejournal.com&target_type=root_domain&export_columns=ascore,total,domains_num,urls_num,ips_num,ipclassc_num,follows_num,nofollows_num,sponsored_num,ugc_num,texts_num,images_num,forms_num,frames_num

Response example

ascore;total;domains_num;urls_num;ips_num;ipclassc_num;follows_num;nofollows_num;sponsored_num;ugc_num;texts_num;images_num;forms_num;frames_num
74;22063983;49145;13059030;47793;22956;20457307;1606307;258;1475;21784602;278624;437;320

Price: 40 API units per line

This report lists backlinks for a domain, root domain, or URL.

Request parameters

Name	Value/Type	Description
type*	backlinks	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	page_ascore, response_code, source_size… page_ascore, response_code, source_size, external_num, internal_num, redirect_url, source_url, source_title, image_url, target_url, target_title, anchor, image_alt, last_seen, first_seen, nofollow, form, frame, image, sitewide, newlink, lostlink	Required columns must be separated by commas.
display_sort	page_ascore_asc, page_ascore_desc, last… page_ascore_asc, page_ascore_desc, last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Default: page_ascore_desc
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
display_filter	type, zone, ip, refdomain, anchor, newl… type, zone, ip, refdomain, anchor, newlink, lostlink, urlanchor, redirects	Filters for columns. Attention. Unfortunately, at the moment you can't use filter urlanchor for domains with a large backlink profile.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example (top 5 new follow links)

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks&target=searchenginejournal.com&target_type=root_domain&export_columns=page_ascore,source_title,source_url,target_url,anchor,external_num,internal_num,first_seen,last_seen&display_limit=5&display_filter=%2B%7Ctype%7C%7Cnewlink%7C%2B%7Ctype%7C%7Cfollow

Response example (top 5 new follow links)

page_ascore;source_title;source_url;target_url;anchor;external_num;internal_num;first_seen;last_seen
80;JDN : E-business, FinTech, Big Data, IoT, tendances média, décideurs...;https://www.journaldunet.com/;https://www.searchenginejournal.com/duckduckgo-is-now-a-default-search-engine-option-on-android-in-the-eu/343073/#close;A partir de mars 2020 DuckDuckGo fera partie des moteurs de recherche proposés par défaut sur Android;137;177;1578929242;1578990011
76;cnBeta.COM - 中文业界资讯站;https://www.cnbeta.com/;https://www.searchenginejournal.com/duckduckgo-is-now-a-default-search-engine-option-on-android-in-the-eu/343073/#close;将成为欧盟 Android 设备的默认搜索引擎选项;68;558;1578902621;1578928080
71;Podcast Alley - Your Place for Podcasting News & Featured Podcasts;https://www.podcastalley.com/;https://www.searchenginejournal.com/bing-pages-this-marketing-oclock-podcast/342897/;Introducing Bing Pages & This Week’s Digital Marketing News [PODCAST] - Search Engine Journal;94;10;1578913376;1578917297
71;Podcast Alley - Your Place for Podcasting News & Featured Podcasts;https://www.podcastalley.com/;https://www.searchenginejournal.com/b2b-paid-advertising-greg-finn-podcast/342657/;B2B Paid Advertising in 2020 with Greg Finn [PODCAST] - Search Engine Journal;94;10;1578576343;1578582160
71;Podcast Alley - Your Place for Podcasting News & Featured Podcasts;https://www.podcastalley.com/;https://www.searchenginejournal.com/google-ads-message-extensions-marketing-oclock-podcast/341909/;Goodbye, Google Ads’ Message Extensions & More News [PODCAST] - Search Engine Journal;94;10;1578300986;1578312791

Price: 40 API units per line

This report lists domains pointing to the queried domain, root domain, or URL.

Request parameters

Name	Value/Type	Description
type*	backlinks_refdomains	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	domain_ascore, domain, backlinks_num, i… domain_ascore, domain, backlinks_num, ip, country, first_seen, last_seen	Required columns must be separated by commas.
display_sort	domain_ascore_asc, domain_ascore_desc, … domain_ascore_asc, domain_ascore_desc, backlinks_num_asc, backlinks_num_desc, last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Default: backlinks_num_desc
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
display_filter	zone, country, ip, newdomain, lostdomai… zone, country, ip, newdomain, lostdomain, category	Filters for columns.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example (top 5 referring domains)

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_refdomains&target=searchenginejournal.com&target_type=root_domain&export_columns=domain_ascore,domain,backlinks_num,ip,country,first_seen,last_seen&display_limit=5

Response example (top 5 referring domains)

domain_ascore;domain;backlinks_num;ip;country;first_seen;last_seen
86;libsyn.com;1850868;204.16.246.222;us;1495338484;1580410670
38;customerguru.in;503992;37.60.254.149;us;1532739198;1578767338
58;obs.co.kr;386005;59.25.202.101;kr;1565621989;1580411659
22;recip-links.com;354282;52.95.147.26;ca;1524707034;1580411673
38;goldenarticles.net;348079;89.190.202.12;bg;1544015188;1580411732

Price: 40 API units per line

This report lists IP addresses where backlinks to a domain, root domain, or URL are coming from.

Request parameters

Name	Value/Type	Description
type*	backlinks_refips	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	ip, country, domains_num, backlinks_num… ip, country, domains_num, backlinks_num, first_seen, last_seen	Required columns must be separated by commas.
display_sort	domains_num_asc, domains_num_desc, back… domains_num_asc, domains_num_desc, backlinks_num_asc, backlinks_num_desc, first_seen_asc, first_seen_desc, last_seen_asc, last_seen_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Default: domains_num_desc
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_refips&target=searchenginejournal.com&target_type=root_domain&export_columns=ip,country,domains_num,backlinks_num,first_seen,last_seen&display_limit=5

Response example

ip;country;domains_num;backlinks_num;first_seen;last_seen
78.69.18.135;se;664;1195;1371696859;1580409277
192.0.78.12;us;357;3675;1534413883;1580408412
192.0.78.13;us;356;4012;1533338180;1580408397
172.217.15.65;us;306;617;1473348232;1580411014
172.217.164.161;us;300;581;1473018187;1580396737

Price: 40 API units per line

This report shows referring domain distributions depending on their top-level domain type.

Request parameters

Name	Value/Type	Description
type*	backlinks_tld	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	zone, domains_num, backlinks_num	Required columns must be separated by commas.
display_sort	domains_num_asc, domains_num_desc, back… domains_num_asc, domains_num_desc, backlinks_num_asc, backlinks_num_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Default: domains_num_desc
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_tld&target=searchenginejournal.com&target_type=root_domain&export_columns=zone,domains_num,backlinks_num&display_limit=5

Response example

zone;domains_num;backlinks_num
com;27755;11645051
net;1894;1684571
org;1486;800180
uk;1267;22572
au;645;9531

Price: 40 API units per line

This report shows referring domain distributions by country (an IP address defines a country).

Request parameters

Name	Value/Type	Description
type*	backlinks_geo	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	country, domains_num, backlinks_num	Required columns must be separated by commas.
display_sort	domains_num_asc, domains_num_desc, back… domains_num_asc, domains_num_desc, backlinks_num_asc, backlinks_num_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Default: domains_num_desc
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_geo&target=searchenginejournal.com&target_type=root_domain&export_columns=country,domains_num,backlinks_num&display_limit=5

Response example

country;domains_num;backlinks_num
United States;36489;5463278
Germany;2594;149154
United Kingdom;1750;102385
France;917;99323
Canada;791;695950

Price: 40 API units per line

This report lists anchor texts used in backlinks leading to the queried domain, root domain, or URL. It also includes the number of backlinks and referring domains per anchor.

Request parameters

Name	Value/Type	Description
type*	backlinks_anchors	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	anchor, domains_num, backlinks_num, fir… anchor, domains_num, backlinks_num, first_seen, last_seen	Required columns must be separated by commas.
display_sort	domains_num_asc, domains_num_desc, back… domains_num_asc, domains_num_desc, backlinks_num_asc, backlinks_num_desc, first_seen_asc, first_seen_desc, last_seen_asc, last_seen_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Default: backlinks_num_desc
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_anchors&target=searchenginejournal.com&target_type=root_domain&export_columns=anchor,domains_num,backlinks_num,first_seen,last_seen&display_limit=5

Response example

anchor;domains_num;backlinks_num;first_seen;last_seen
search engine journal;8113;691263;1370650463;1580411804
93% of people;3;354284;1524707034;1580411673
the growth of social media v2.0 | search engine journal;1;251996;1532739198;1578767338
more;57;153884;1452198531;1580411620
read more >;2;114350;1545826610;1580411612

Price: 40 API units per line

This report shows indexed pages of the queried domain

Request parameters

Name	Value/Type	Description
type*	backlinks_pages	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	source_url, source_title, response_code… source_url, source_title, response_code, backlinks_num, domains_num, last_seen, external_num, internal_num	Required columns must be separated by commas.
display_sort	backlinks_num_asc, backlinks_num_desc, … backlinks_num_asc, backlinks_num_desc, domains_num_asc, domains_num_desc, last_seen_asc, last_seen_desc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order. Default: backlinks_num_desc
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_pages&target=searchenginejournal.com&target_type=root_domain&export_columns=source_url,source_title,response_code,backlinks_num,domains_num,last_seen,external_num,internal_num&display_sort=domains_num_desc&display_limit=5

Response example

source_url;source_title;response_code;backlinks_num;domains_num;last_seen;external_num;internal_num
https://www.searchenginejournal.com/;Search Engine Journal - SEO, Search Marketing News and Tutorials;200;129873;3602;1580113263;16;405
http://www.searchenginejournal.com/;;301;213841;3543;1580400186;0;0
https://www.searchenginejournal.com/seo-101/seo-statistics/;60+ Mind-Blowing Search Engine Optimization Stats - SEO 101;200;11746;1675;1580367611;88;156
https://www.searchenginejournal.com/24-eye-popping-seo-statistics/42665/;;301;3127;822;1579709305;0;0
https://www.searchenginejournal.com/seo-guide/;A Complete Guide to SEO | Search Engine Journal;200;12856;743;1580411596;19;130

Price: 40 API units per line

A list of domains with a similar backlink profile to the analyzed domain.

Request parameters

Name	Value/Type	Description
type*	backlinks_competitors	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	ascore, neighbour, similarity, common_r… ascore, neighbour, similarity, common_refdomains, domains_num, backlinks_num	Required columns must be separated by commas.
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_competitors&target=searchenginejournal.com&target_type=root_domain&export_columns=ascore,neighbour,similarity,common_refdomains,domains_num,backlinks_num&display_limit=5

Response example

ascore;neighbour;similarity;common_refdomains;domains_num;backlinks_num
80;searchengineland.com;36;17584;79939;42840590
74;searchenginewatch.com;34;11537;47115;35855777
68;wordstream.com;32;9575;37065;1750926
77;moz.com;31;15732;103754;21136846
76;marketingland.com;30;9058;39986;9756098

Price: 40 API units per line

This report shows how many backlinks are sent to you and your competitors from the same referring domains.

Request parameters

Name	Value/Type	Description
type*	backlinks_matrix	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
targets[]*	targets[] = example.com&targets[] = www… targets[] = example.com&targets[] = www.example.com&targets[] = http://www.example.com	An array of items, where an item is a root domain, domain or URL.
target_types[]*	target_types[] = root_domain&target_typ… target_types[] = root_domain&target_types[] = domain&target_types[] = url	An array of items, where an item is a type of requested target specified in the parameter "targets[]".
export_columns*	domain, domain_ascore, matches_num, bac… domain, domain_ascore, matches_num, backlinks_num	Required columns must be separated by commas.
display_sort	domain_ascore_desc, domain_ascore_asc, … domain_ascore_desc, domain_ascore_asc, matchesnum_desc, matchesnum_asc, backlinksnum_0_desc, backlinksnum_0_asc, backlinksnum_1_desc, backlinksnum_1_asc, backlinksnum_2_desc, backlinksnum_2_asc, backlinksnum_3_desc, backlinksnum_3_asc, backlinksnum_4_desc, backlinksnum_4_asc, backlinksnum_5_desc, backlinksnum_5_asc	This parameter allows you to choose by which column you would like to sort your results—in either ascending or descending order.
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.
display_filter	backlinksnum_0, backlinksnum_1, backlin… backlinksnum_0, backlinksnum_1, backlinksnum_2, backlinksnum_3, backlinksnum_4, backlinksnum_5	Filters for columns.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example (domains that don't link to searchenginejournal.com)

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_matrix&targets[]=searchenginejournal.com&targets[]=searchengineland.com&target_types[]=root_domain&target_types[]=root_domain&export_columns=domain,domain_ascore,matches_num,backlinks_num&display_limit=5&display_filter=%2B%7Cbacklinksnum_0%7CEq%7C0

Response example (domains that don't link to searchenginejournal.com)

domain;domain_ascore;matches_num;searchenginejournal.com;searchengineland.com
squarespace.com;85;1;0;4
cloudflare.com;92;1;0;8
amazon.com;94;1;0;2
progresspond.com;65;1;0;2
slideshare.net;88;1;0;9

Price: 40 API units per line

Compare your and your competitors' backlink profiles and link-building progress.

Request parameters

Name	Value/Type	Description
type*	backlinks_comparison	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to Semrush. The key is available on the Profile page.
targets[]*	targets[] = example.com&targets[] = www… targets[] = example.com&targets[] = www.example.com&targets[] = http://www.example.com	An array of items, where an item is a root domain, subdomain or URL.
target_types[]*	target_types[] = root_domain&target_typ… target_types[] = root_domain&target_types[] = domain&target_types[] = url	An array of items, where an item is a type of requested target specified in the parameter "targets[]".
export_columns*	target, target_type, ascore, backlinks_… target, target_type, ascore, backlinks_num, domains_num, ips_num, follows_num, nofollows_num, texts_num, images_num, forms_num, frames_num	Required columns must be separated by commas.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_comparison&targets[]=ebay.com&targets[]=amazon.com&target_types[]=root_domain&target_types[]=root_domain&export_columns=target,target_type,ascore,backlinks_num,domains_num,ips_num,follows_num,nofollows_num,texts_num,images_num,forms_num,frames_num

Response example

target;target_type;ascore;backlinks_num;domains_num;ips_num;follows_num;nofollows_num;texts_num;images_num;forms_num;frames_num
ebay.com;root_domain;94;15248332274;461273;321889;6863043986;8385235217;11753970129;3487503037;6183483;675625
amazon.com;root_domain;94;6258027263;2679680;1012020;3901022285;2355705949;4522715595;1637657601;14954399;82699668

Price: 100 API units per request

This report returns distribution of referring domains by Authority Score. When you run a query for a domain, in return, for each Authority Score value [from 0 to 100], you receive a number of domains that have at least one link, pointing to queried domain.

Request parameters

Name	Value/Type	Description
type*	backlinks_ascore_profile	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_ascore_profile&target=searchenginejournal.com&target_type=root_domain

Response example

ascore;domains_num
0;941
1;60
2;114
3;227
4;433
5;810
...
95;2
96;0
97;1
98;1
99;0
100;0

Price: 40 API units per line

This report returns the list of categories that referring domains belong to. When you run a query for a domain, in return, in each line, you receive a category and a number of domains that have at least one link, pointing to queried domain, that have such category. Results are sorted by a number of referring domains in descending order. This report is generated, based on the first 10,000 referring domains for given queried domain.

Request parameters

Name	Value/Type	Description
type*	backlinks_categories_profile	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	category_name, rating	Required columns must be separated by commas.
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.
display_offset	integer	This parameter allows you to skip a specified number of results before sending a report. Please keep in mind that if you use the option display_offset, display_limit, the value should be increased by value display_offset.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_categories_profile&target=searchenginejournal.com&target_type=root_domain&export_columns=category_name,rating&display_limit=5

Response example

category_name;rating
/Business & Industrial/Advertising & Marketing/Marketing;2188
/Internet & Telecom/Web Services/Search Engine Optimization & Marketing;1975
/Business & Industrial/Advertising & Marketing/Brand Management;1725
/Business & Industrial/Advertising & Marketing/Sales;1116
/Internet & Telecom/Web Services/Web Design & Development;1001

Price: 50 API units per request

This report returns the list of categories queried domain belong to. When you run a query for a domain, in return, in each line, you receive a category and a rating. Rating is a level of confidence that this domain belongs to this category (ranged from 0 to 1). Results are sorted by the rating.

Request parameters

Name	Value/Type	Description
type*	backlinks_categories	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com, www.example.com or http://… example.com, www.example.com or http://www.example.com	A root domain, domain or URL address.
target_type*	root_domain, domain or url	A type of requested target
export_columns*	category_name, rating	Required columns must be separated by commas. Rating - a level of confidence that domain specified in target field belongs to this category (ranges from 0 to 1).

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_categories&target=searchenginejournal.com&target_type=root_domain&export_columns=category_name,rating

Response example

category_name;rating
/Internet & Telecom/Web Services/Search Engine Optimization & Marketing;0.931905
/Internet & Telecom/Web Services/Affiliate Programs;0.880989
/Business & Industrial/Advertising & Marketing/Marketing;0.872495
/Internet & Telecom/Search Engines;0.821398
/Business & Industrial/Advertising & Marketing/Brand Management;0.813207

Price: 40 API units per line

This report returns only monthly historical trends of number of backlinks and referring domains for queried domain. When you run a query for a domain, in return, in each line, you receive a date and a number of backlinks and referring domains queried domain had on this date. Results are sorted by date in descending order (from most recent to oldest).

Request parameters

Name	Value/Type	Description
type*	backlinks_historical	The report type.
key*	API_KEY	An identification key assigned to a user after subscribing to SEMrush. The key is available on the Profile page.
target*	example.com	Only root domain
target_type*	root_domain	A type of requested target
export_columns*	date, backlinks_num, domains_num	Required columns must be separated by commas.
display_limit	integer	The number of results returned to a request; if this parameter is not specified or equals to 0, the default value will be 10,000 lines.

* Fields marked by an asterisk (*) are required

Endpoint

https://api.semrush.com/analytics/v1/

Request example

https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_historical&target=searchenginejournal.com&target_type=root_domain&export_columns=date,backlinks_num,domains_num&display_limit=5

Response example

date;backlinks_num;domains_num
1618185600;18768868;266988
1617580800;19005841;270238
1616976000;19145818;270371
1616371200;20011497;309865
1615766400;20669614;383991

Backlinks

Backlinks overview

Request parameters

Backlinks

Request parameters

Referring domains

Request parameters

Referring IPs

Request parameters

TLD distribution

Request parameters

Referring domains by country

Request parameters

Anchors

Request parameters

Indexed pages

Request parameters

Competitors

Request parameters

Comparison by referring domains

Request parameters

Batch comparison

Request parameters

Authority score profile

Request parameters

Categories profile

Request parameters

Categories

Request parameters

Historical data

Request parameters