Referring Domains
Referring domains are the distinct websites that link to a domain or page, each counted once with its authority rank, the number of links and linking pages it contributes, how many of those pages are nofollow or point at broken pages, a spam score, and the dates it started and stopped linking. Counting sites rather than raw links gives the fairest measure of link popularity, which makes these rows the basis for outreach lists, link gap comparisons and reports on linking sites won and lost.
Referring Domains API Features
- One row per linking domainEach row the Referring Domains API returns is a site that links to the target domain, subdomain or page, so a blog with 300 links to you still appears once; results_limit returns 1 to 1,000 of them.
- How deeply each domain linksbacklinks_count and referring_pages_count show how many links and pages a domain contributes, and nofollow_referring_pages_count and broken_backlinks_count show how many of them are nofollow or land on dead pages.
- Quality signals per siterank gives the linking domain's authority from 0 to 1000 and spam_score rates it from 0 to 100, enough to sort a long list before anyone reads it.
- Start and end of each relationshipfirst_seen_at records when the domain's first link was found, and lost_at records when it stopped linking, staying empty while the link is live.
Referring Domains API Parameters
| Parameters | Required | Description |
|---|---|---|
target | Required | Domain, subdomain or full page URL whose linking domains you want, such as notion.so or https://example.com/pricing. |
results_limit | Optional | Number of referring domains to return, an integer from 1 to 1000; defaults to 100. |
How to Use the Referring Domains API
Submit a target with a results_limit to the Referring Domains API, then collect the linking domains page by page.
- POST {"target": "notion.so", "results_limit": 100} to /v1/seo/referring-domains and save the task_id.
- Poll GET /v1/tasks/{task_id}; the domains are ready once status is succeeded.
- Read each domain from results.items, and while has_more is true request the next page with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/seo/referring-domains" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","results_limit":100}'
# Poll GET /v1/tasks/{task_id} for the linking domains.Referring Domains API Use Cases
- Building an outreach list from a competitor: Run a competitor's domain through the Referring Domains API, keep rows with a high rank and a low spam_score, and contact the sites behind each domain.
- Checking a link gap between two sites: Pull the referring domains of your site and a competitor, then compare the domain columns to find sites that link only to the competitor.
- Reporting linking sites lost: Filter rows where lost_at is set and sort them by rank to see which valuable sites dropped their links, and when.
- Reviewing links repeated across many pages: Sort by referring_pages_count to find domains that link from hundreds of pages, such as footer, sidebar or blogroll placements worth reviewing.
Referring Domains API Pro Tips
- When nofollow_referring_pages_count equals referring_pages_count in a Referring Domains API row, every linking page on that domain is nofollow; use that check to separate domains that pass ranking value from those that do not.
- If a domain shows broken_backlinks_count above zero, run the Backlinks API on the same target to find the exact target_url values that fail, then redirect them.
- Check referring_domains_count in the Backlinks Summary API before a large pull, since one Referring Domains API request returns at most 1,000 domains and a bigger profile will be covered only in part.
Related APIs
Beyond the Referring Domains API, use these APIs when you need a different type of public SEO data.
- Google Organic SERP API — Retrieve one live Google result page by query and market with normalized destinations, ranks, element types, and full result details.
- Keyword Difficulty API — Compare organic ranking difficulty for a submitted keyword batch, returning each available keyword with its normalized score.
- Keyword Overview API — Enrich a submitted keyword batch with available demand, paid competition, difficulty, monthly-search, and intent context.
- Backlinks Summary API — Summarise the link profile of one domain, subdomain or page in a single row with authority rank, backlink and referring-domain totals, spam score and link source breakdowns.
- Backlinks API — List up to 1,000 individual links to a domain or page, strongest first, with source page, anchor text, dofollow status, authority scores and first and last seen dates.
- Backlink Competitors API — Find the domains that share the most referring domains with a site or page, ordered by that overlap and shown with their authority rank.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API