Refdomains

API + MCP

GET/v3/site-explorer/refdomains

Query parameters

selectstringRequired

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

wherestring

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

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

limitinteger

The number of results to return.

Default:1000

timeoutinteger

A manual timeout duration in seconds.

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

modestring

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

Allowed values:exactprefixdomainsubdomains

Default:subdomains

targetstring (url)Required

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

protocolstring

The protocol of your target.

Allowed values:bothhttphttps

Default:both

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.