Developer
Telephone
United States
+1 (800) 815 - 9959
10:00 AM - 5:00 PM (EST/EDT)
Monday - Friday
Backlinks
Analytics
Last updated: April 30, 2024
Last updated: April 30, 2024
Backlinks overview
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 (GET)
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
Backlinks
This report lists backlinks for a domain, root domain, or URL.
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | backlinks | Report type. |
| key* | API_KEY | Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units. |
| target* |
example.com, www.example.com, or http:/…
example.com, www.example.com, or http://www.example.com
|
Root domain, domain, or URL. |
| target_type* | root_domain, domain, or url | 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
|
This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default. |
| 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 | Number of results to return. If this parameter isn't specified or equals The available range is between |
| display_offset | integer | This parameter allows you to skip a specified number of results before sending a report. Keep in mind that if you use the |
| 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 (GET)
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
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 ascending or descending order. |
| display_limit | integer | The number of results returned to a request. If this parameter is not specified or equals |
| 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 (GET)
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
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 ascending or descending order. |
| display_limit | integer | The number of results returned to a request. If this parameter is not specified or equals |
| 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 (GET)
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
This report shows the referring domain distribution depending on the top-level domain (TLD) 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 ascending or descending order. |
| display_limit | integer | The number of results returned to a request. If this parameter is not specified or equals |
| 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 (GET)
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
This report shows the referring domain distribution by country. The IP address of a domain is used to define 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 ascending or descending order. |
| display_limit | integer | The number of results returned to a request. If this parameter is not specified or equals |
| 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 (GET)
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
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 ascending or descending order. |
| display_limit | integer | The number of results returned to a request. If this parameter is not specified or equals |
| 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 (GET)
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
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 ascending or descending order. |
| display_limit | integer | The number of results returned to a request. If this parameter is not specified or equals |
| 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 (GET)
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
This report lists domains that share a similar backlink profile with 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 |
| 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 (GET)
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
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 |
| 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 ascending or descending order. |
| display_limit | integer | The number of results returned to a request. If this parameter is not specified or equals |
| 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 (GET)
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
Compare your backlink profile and link-building progress with those of your competitors.
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 |
| 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 (GET)
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
This report returns the 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 with at least one link pointing to the 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 (GET)
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
This report returns a list of categories that the referring domains of the queried domain belong to.
When you run a query for a domain, in each line, you get a category and the number of domains in that category with at least one link pointing to the queried domain. The results are sorted by the number of referring domains in descending order. This report is generated based on the first 10,000 referring domains for the queried domain.
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | backlinks_categories_profile | Report type. |
| key* | API_KEY | Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units. |
| target* |
example.com, www.example.com or http://…
example.com, www.example.com or http://www.example.com
|
Root domain, domain, or URL. |
| target_type* | root_domain, domain or url | Type of requested target. |
| export_columns* | category_name, rating | This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default. Note that |
| display_limit | integer | Number of results returned to a request. If this parameter isn't specified or equals |
| display_offset | integer | This parameter lets you skip a specified number of results before sending a report. Keep in mind that if you use the |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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
This report returns a list of categories that the queried domain belongs to.
When you run a query for a domain, in each line, you get a category and a rating. The rating reflects the level of confidence that this domain belongs to this category (ranging from 0 to 1). The results are sorted by the rating.
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | backlinks_categories | Report type. |
| key* | API_KEY | Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units. |
| target* |
example.com, www.example.com or http://…
example.com, www.example.com or http://www.example.com
|
Root domain, subdomain, or URL. |
| target_type* | root_domain, subdomain or url | Type of requested target. |
| export_columns* | category_name, rating | This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default. Rating is the level of confidence that the domain specified as |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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
This report returns only monthly historical trends of multiple backlinks and referring domains for the queried domain.
When you run a query for a domain, in return, in each line, you receive a date (Unix timestamp) and the number of backlinks and referring domains the queried domain had at that time. Results are sorted by date from the most recent to the oldest.
Request parameters
| Name | Value/Type | Description |
|---|---|---|
| type* | backlinks_historical | Report type. |
| key* | API_KEY | Identification key assigned to each user after subscribing to Semrush. You'll find it in Subscription info > API units. |
| target* | example.com | Target type. Root domain only. |
| target_type* | root_domain | Type of requested target. |
| export_columns* |
date, backlinks_num, backlinks_lost_num…
date, backlinks_num, backlinks_lost_num, backlinks_new_num, domains_num, domains_new_num, domains_lost_num, score
|
This parameter lets you get only the columns with the data you need. Specify the required columns separating them by a comma. If this parameter isn't specified, all columns are shown by default. |
| display_limit | integer | Number of results returned to a request. If this parameter is not specified or equals |
* Fields marked by an asterisk (*) are required
Endpoint (GET)
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