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

Backlinks

Analytics divider Last updated: August 18, 2021
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

Referring domains

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

Referring IPs

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

TLD distribution

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

Referring domains by country

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

Anchors

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

Indexed pages

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

Competitors

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

Comparison by referring domains

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

Batch comparison

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

Authority score profile

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

Categories profile

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

Categories

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

Historical data

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