Refdomains

API + MCP

GET/v3/site-explorer/refdomains

Query parameters

timeoutinteger

A manual timeout duration in seconds.

limitinteger

The number of results to return.

Default:1000

order_bystring

A comma-separated list of columns to order results by, with optional direction. See response schema for valid column identifiers.

Example:field_a,field_b:asc,field_c:desc

wherestring

The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the select parameter).

selectstringRequired

A comma-separated list of columns to return. See response schema for valid column identifiers.

protocolstring

The protocol of your target.

Allowed values:bothhttphttps

Default:both

targetstring (url)Required

The target of the search: a domain or a URL.

modestring

The scope of the search based on the target you entered.

Allowed values:exactprefixdomainsubdomains

Default:subdomains

historystring

A time frame to add lost backlinks to the report. Choose between live (no history), since:<date> (history since a specified date), and all_time (full history). The date should be in YYYY-MM-DD format.

Default:all_time

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

refdomainsarray<object>

dofollow_linked_domainsinteger

The number of unique root domains with dofollow links linked from the referring domain.

dofollow_linksinteger

The number of links from the referring domain to your target that don't have the “nofollow” attribute.

dofollow_refdomainsinteger

(5 units) The number of unique domains with dofollow links to the referring domain.

domainstring

A referring domain that has at least one link to your target.

domain_ratingnumber (float)

The strength of a domain's backlink profile compared to the others in our database on a 100-point scale.

first_seenstring (date-time)

The date we first found a backlink to your target from the referring domain.

ip_sourcestring or null

The referring domain IP address.

is_root_domainboolean

The domain name is a root domain name.

is_spamboolean

Indicates whether the backlink comes from a known spammy domain.

last_seenstring (date-time) or null

The date your target lost its last live backlink for the referring domain.

links_to_targetinteger

The number of backlinks from the referring domain to your target.

lost_linksinteger

The number of backlinks lost from the referring domain for the selected time period.

new_linksinteger

The number of new backlinks found from the referring domain for the selected time period.

positions_source_domaininteger

The number of keywords that the referring domain ranks for in the top 100 positions.

traffic_domaininteger

(10 units) The referring domain's estimated monthly organic traffic from search.