Backlinks

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.

About the Backlink Analytics Overview report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_overview

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

This parameter lets you get only the columns with the data you need. Specify the required columns separated by a comma.

If this parameter isn’t specified, the default columns will be sent (total, domains_num, ips_num, follows_num, nofollows_num, score, trust_score, urls_num, ipclassc_num, texts_num, forms_num, frames_num, images_num).

Value/Type: 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

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 exampleCSV
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.

About the Backlinks report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com, or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain, or url

export_columns

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be sent: page_score, source_title, source_url, target_url, anchor, external_num, internal_num, first_seen, last_seen.

page_score shows the same data as page_ascore. But if you want to request it specifically, use page_ascore.

Value/Type: 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

display_sort

Use this parameter to choose which column to sort your results by, in ascending or descending order.

Default: page_ascore_desc

Value/Type: page_ascore_asc, page_ascore_desc, last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc

display_limit

Number of results to return. If this parameter isn’t specified or equals 0, 10,000 lines are returned by default.

The available range is between 0 and 1000000.

Value/Type: integer

display_offset

This parameter allows you to skip a specified number of results before sending a report.

Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

display_filter

Filters for columns.
Note that you can’t currently use the urlanchor filter for domains with a large backlink profile.

Value/Type: type, zone, ip, refdomain, anchor, newlink, lostlink, urlanchor, redirects

Request example
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 exampleCSV
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

Jump to Referring domainsReferring domains

Price: 40 API units per line

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

About the Referring Domains report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_refdomains

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, the default columns will be included: domain, backlinks_num, domain_score, domain_trust_score, first_seen, last_seen, ip, country.

domain_score shows the same data as domain_ascore. But if you want to request it specifically, use domain_ascore.

Value/Type: domain_ascore, domain_score, domain, backlinks_num, domain_trust_score, ip, country, first_seen, last_seen

display_sort

This parameter allows you to choose by which column you would like to sort your results in ascending or descending order.
Default: backlinks_num_desc.

Value/Type: domain_ascore_asc, domain_ascore_desc, backlinks_num_asc, backlinks_num_desc, last_seen_asc, last_seen_desc, first_seen_asc, first_seen_desc

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, the default value will be 10,000 lines.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

display_filter

Filters for columns.

Value/Type: zone, country, ip, newdomain, lostdomain, category

Request example
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 exampleCSV
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

Jump to Referring IPsReferring IPs

Price: 40 API units per line

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

About the Referring IPs report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_refips

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, all columns will be included.

Value/Type: ip, country, domains_num, backlinks_num, first_seen, last_seen

display_sort

Use this parameter to choose which column to sort your results by, in ascending or descending order.

Default: domains_num_desc.

Value/Type: domains_num_asc, domains_num_desc, backlinks_num_asc, backlinks_num_desc, first_seen_asc, first_seen_desc, last_seen_asc, last_seen_desc

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, you’ll get 10,000 lines by default.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

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 exampleCSV
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

Jump to TLD distributionTLD distribution

Price: 40 API units per line

This report shows the referring domain distribution depending on the top-level domain (TLD) type.

About the Referring Domains report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_tld

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, all columns will be included.

Value/Type: zone, domains_num, backlinks_num

display_sort

Use this parameter to choose which column to sort your results by, in ascending or descending order.

Default: domains_num_desc.

Value/Type: domains_num_asc, domains_num_desc, backlinks_num_asc, backlinks_num_desc

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, the default value will be 10,000 lines.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

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 exampleCSV
zone;domains_num;backlinks_num
com;27755;11645051
net;1894;1684571
org;1486;800180
uk;1267;22572
au;645;9531

Jump to Referring domains by countryReferring domains by country

Price: 40 API units per line

This report shows the referring domain distribution by country. The IP address of a domain is used to define a country.

About the Referring Domains report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_geo

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, all columns will be included.

Value/Type: country, domains_num, backlinks_num

display_sort

Use this parameter to choose which column to sort your results by, in ascending or descending order.

Default: domains_num_desc.

Value/Type: domains_num_asc, domains_num_desc, backlinks_num_asc, backlinks_num_desc

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, the default value will be 10,000 lines.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

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 exampleCSV
country;domains_num;backlinks_num
United States;36489;5463278
Germany;2594;149154
United Kingdom;1750;102385
France;917;99323
Canada;791;695950

Jump to AnchorsAnchors

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.

About the Anchors report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_anchors

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, all columns will be included.

Value/Type: anchor, domains_num, backlinks_num, first_seen, last_seen

display_sort

Use this parameter to choose which column to sort your results by, in ascending or descending order.

Default: backlinks_num_desc.

Value/Type: domains_num_asc, domains_num_desc, backlinks_num_asc, backlinks_num_desc, first_seen_asc, first_seen_desc, last_seen_asc, last_seen_desc

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, the default value will be 10,000 lines.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

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 exampleCSV
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

Jump to Indexed pagesIndexed pages

Price: 40 API units per line

This report shows indexed pages of the queried domain.

About the Indexed Pages report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_pages

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, all columns will be included.

Value/Type: source_url, source_title, response_code, backlinks_num, domains_num, last_seen, external_num, internal_num

display_sort

Use this parameter to choose which column to sort your results by, in ascending or descending order.

Default: backlinks_num_desc.

Value/Type: backlinks_num_asc, backlinks_num_desc, domains_num_asc, domains_num_desc, last_seen_asc, last_seen_desc

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, the default value will be 10,000 lines.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

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 exampleCSV
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

Jump to CompetitorsCompetitors

Price: 40 API units per line

This report lists domains that share a similar backlink profile with the analyzed domain.

About the Competitors report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_competitors

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, all columns will be included.

Value/Type: score, neighbour, similarity, common_refdomains, domains_num, backlinks_num

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, the default value will be 10,000 lines.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

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 exampleCSV
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

Jump to Comparison by referring domainsComparison 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.

About the Referring Domains report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_matrix

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targets[]Required

Array of items, where an item is a root domain, subdomain, or URL of the website you’d like to investigate..

Value/Type: targets[] = example.com&targets[] = www.example.com&targets[] = http://www.example.com

target_types[]Required

Array of items, where an item is a type of requested target specified in the targets[] parameter.

Use domain to get data on a subdomain.

Value/Type: target_types[] = root_domain&target_types[] = domain&target_types[] = url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, all columns will be included.

domain_score shows the same data as domain_ascore. But if you want to request it specifically, use domain_ascore.

Value/Type: domain, domain_ascore, domain_score, matches_num, backlinks_num

display_sort

Use this parameter to choose which column to sort your results by, in ascending or descending order.

Default: domain_score_desc.

Value/Type: domain_score_desc, domain_score_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

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, you’ll get 10,000 lines by default.

Value/Type: integer

display_offset

This parameter allows you to skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

display_filter

Filters for columns.

Value/Type: backlinksnum_0, backlinksnum_1, backlinksnum_2, backlinksnum_3, backlinksnum_4, backlinksnum_5

Request example
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 exampleCSV
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

Jump to Batch comparisonBatch comparison

Price: 40 API units per line

Compare your backlink profile and link-building progress with those of your competitors.

About the Bulk Backlink Analysis report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_comparison

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targets[]Required

Array of items, where an item is a root domain, subdomain, or URL of the website you’d like to investigate..
The limit is 200 targets.

Value/Type: targets[] = example.com&targets[] = www.example.com&targets[] = http://www.example.com

target_types[]Required

Array of items, where an item is a type of requested target specified in the targets[] parameter.

Use domain to get data on a subdomain.

Value/Type: target_types[] = root_domain&target_types[] = domain&target_types[] = url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If you don’t set this parameter, all columns will be included.

Value/Type: target, target_type, ascore, backlinks_num, domains_num, ips_num, follows_num, nofollows_num, texts_num, images_num, forms_num, frames_num

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 exampleCSV
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

Jump to Authority Score profileAuthority Score profile

Price: 100 API units per request

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.

About the Authority Score metric ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_ascore_profile

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

Request example
https://api.semrush.com/analytics/v1/?key=YOUR_API_KEY&type=backlinks_ascore_profile&target=searchenginejournal.com&target_type=root_domain
Response exampleCSV
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

Jump to Categories profileCategories profile

Price: 40 API units per line

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.

About the Referring Domains report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_categories_profile

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Use domain to get data on a subdomain.

Value/Type: root_domain, domain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If this parameter isn’t specified, all columns are shown by default.

Note that rating as the parameter name doesn’t correspond to the data returned. The data reflects the number of domains in the category that have backlinks to the queried domain.

Value/Type: category_name, rating

display_limit

Number of results returned to a request. If this parameter isn’t specified or equals 0, the default value will be 10,000 lines.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.

Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

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 exampleCSV
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

Jump to CategoriesCategories

Price: 50 API units per request

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.

About the Referring Domains report ›

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_categories

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Root domain, subdomain, or URL of the website you’d like to investigate.

Value/Type: example.com, www.example.com or http://www.example.com

target_typeRequired

Type of requested target.

Value/Type: root_domain, subdomain or url

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by a comma.

If this parameter isn’t specified, all columns are shown by default.

rating shows the confidence level that the target domain belongs to this category. It ranges from 0 to 1 — the closer the number is to 1, the higher the confidence.

Value/Type: category_name, rating

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 exampleCSV
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

Jump to Historical dataHistorical data

Price: 40 API units per line

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.

Jump to EndpointEndpoint

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

Request Parameters

typeRequired

Report type.

Value/Type: backlinks_historical

keyRequired

Identification key assigned to each user after subscribing to Semrush. You’ll find it in Subscription info > API units.

Value/Type: API_KEY

targetRequired

Target type. Root domain only.

Value/Type: example.com

target_typeRequired

Type of requested target.

Value/Type: root_domain

export_columnsRequired

Use this parameter to choose which columns to include in the response. List the column names, separated by commas.

If this parameter isn’t specified, the following columns are shown by default: date, backlinks_num, domains_num, score.

Value/Type: date, backlinks_num, domains_num, score

display_limit

Number of results returned to a request. If this parameter is not specified or equals 0, the default value will be 10,000 lines.

Value/Type: integer

display_offset

This parameter lets you skip a specified number of results before sending a report.
Keep in mind that if you use the display_offset option, the display_limit value should be increased by the value set in display_offset.

Value/Type: integer

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 exampleCSV
date;backlinks_num;domains_num
1618185600;18768868;266988
1617580800;19005841;270238
1616976000;19145818;270371
1616371200;20011497;309865
1615766400;20669614;383991

Last updated: January 26, 2026

Was this page helpful?