Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Need help?
Telephone
United States
United States
Canada
United Kingdom
Spain
France
Italy
Germany
Australia
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
This report provides a summary of backlinks, including their type, referring domains and IP addresses for a domain, root domain, or URL.
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
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
This report lists backlinks for a domain, root domain, or URL.
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. |
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. |
display_filter |
type, zone, ip, refdomain, anchor, newl…
type, zone, ip, refdomain, anchor, newlink, lostlink, urlanchor, redirects
|
Filters for columns. |
* Fields marked by an asterisk (*) are required
Endpoint
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
This report lists domains pointing to the queried domain, root domain, or URL.
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. |
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. |
display_filter |
zone, country, ip, newdomain, lostdomai…
zone, country, ip, newdomain, lostdomain, category
|
Filters for columns. |
* Fields marked by an asterisk (*) are required
Endpoint
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
This report lists IP addresses where backlinks to a domain, root domain, or URL are coming from.
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. |
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. |
* Fields marked by an asterisk (*) are required
Endpoint
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
This report shows referring domain distributions depending on their top-level domain type.
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. |
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. |
* Fields marked by an asterisk (*) are required
Endpoint
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
This report shows referring domain distributions by country (an IP address defines a country).
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. |
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. |
* Fields marked by an asterisk (*) are required
Endpoint
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
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.
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. |
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. |
* Fields marked by an asterisk (*) are required
Endpoint
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
This report shows indexed pages of the queried domain
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. |
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. |
* Fields marked by an asterisk (*) are required
Endpoint
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
A list of domains with a similar backlink profile to the analyzed domain.
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. |
* Fields marked by an asterisk (*) are required
Endpoint
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
This report shows how many backlinks are sent to you and your competitors from the same referring domains.
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. |
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
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
Compare your and your competitors' backlink profiles and link-building progress.
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
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
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.
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
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
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.
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. |
* Fields marked by an asterisk (*) are required
Endpoint
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
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.
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
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
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).
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
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