Skip to content
telipot
telipot
Join the waitlistSign in

Referring domains of a domain or URL with Authority Score.

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

Job seo.backlinks.refdomains

Your AI asks

checks the price first
telipot run semrush.seo.backlinks.refdomains \
  --input-json '{"type":"backlinks_refdomains","target":"stripe.com","target_type":"root_domain","display_limit":1,"export_columns":"domain_ascore,domain,backlinks_num,first_seen,last_seen"}' \
  --quote

Price

Semrush API units
Priced· before it runs

semrush.seo.backlinks.refdomains

Semrush API unitsYour plan

Whose account it uses

1The person asking
not needed
2Your company’s Semrush plan
Selected identity for this example
3Our account
not used

What it sends

{
  "type": "backlinks_refdomains",
  "target": "stripe.com",
  "target_type": "root_domain",
  "display_limit": 1,
  "export_columns": "domain_ascore,domain,backlinks_num,first_seen,last_seen"
}

Your Semrush login is added for you. Your AI never sees it.

What it costs

40 API units

per result · no USD rate

rate40 API units per result, billed per result
sourcedocs · developer.semrush.com/api/v3/seo/backlinks/#referring-domains · checked 2026-10-05
confidencedocumented
note40 API units per line returned. Semrush does not charge a request that returns no data. Semrush publishes no USD price per API unit.

Preview the price first. --quote runs nothing.

For developers · run it

Shell · runs the task on the named account

telipot run semrush.seo.backlinks.refdomains \
  --input-json '{"type":"backlinks_refdomains","target":"stripe.com","target_type":"root_domain","display_limit":1,"export_columns":"domain_ascore,domain,backlinks_num,first_seen,last_seen"}'

type

string · required · const "backlinks_refdomains"

Fixed. Selects the Referring domains report.

target

string · required

Root domain, subdomain, or URL of the website to investigate: example.com, www.example.com or http://www.example.com.

target_type

string · required · one of "root_domain", "domain", "url"

Type of the target. Use domain for a subdomain.

display_limit

integer · required · at least 1

Lines returned, which is what Semrush bills. Semrush returns 10,000 lines when the parameter is omitted or 0, so this task requires it.

display_offset

integer · at least 0

Lines to skip before the report starts. Semrush counts display_limit from the first line, so set display_limit to display_offset plus the lines wanted.

display_sort

string · one of "domain_ascore_asc", "domain_ascore_desc", "backlinks_num_asc", "backlinks_num_desc", "last_seen_asc", "last_seen_desc", "first_seen_asc", "first_seen_desc"

Sort rule, one per call. Semrush sorts by backlinks_num_desc when it is omitted.

display_filter

string

Filters on zone, country, ip, newdomain, lostdomain and category, joined with |. Semrush gives no example for this report. Write it in plain text; the + must reach Semrush as %2B.

export_columns

string · required

Comma-separated column codes, in the order wanted. domain_ascore Domain Authority Score (domain_score is the same), domain, backlinks_num backlinks from the domain, domain_trust_score, ip, country, first_seen and last_seen as Unix timestamps.

output

string

CSV text: a header line of the requested column codes, then one line per referring domain, columns separated by semicolons, in the order of export_columns. A body that starts with ERROR is a failure, for example ERROR 50 :: NOTHING FOUND.
Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "type": "string",
  "pattern": "^(?!\\s*ERROR)",
  "description": "CSV text: a header line of the requested column codes, then one line per referring domain, columns separated by semicolons, in the order of export_columns. A body that starts with ERROR is a failure, for example ERROR 50 :: NOTHING FOUND."
}

A real answer

No example captured yet: one is recorded when telipot catalog verify passes.