seo/
backlinks-summary

The Backlinks Summary API condenses the link profile of a domain, subdomain or page URL in one row: authority rank, backlink and referring-domain totals, nofollow and broken counts, and spam score.

Backlinks Summary API

Domain or page target
0–1000 authority rank
Link source breakdowns
10 credits / request
Ready
README

By SocQ · Updated

Backlinks Summary

A backlink profile is the whole set of links that other sites point at a domain or page, measured here by an authority rank from 0 to 1000, totals of backlinks, referring domains, IPs and subnets, a spam score from 0 to 100, and breakdowns of the linking sites by country, top-level domain, site type and position on the page. Read together, these figures show how strong and how varied a site's links are, which is what a link audit, an authority comparison between sites or a background check on a partner needs first.

Backlinks Summary API Features

  • Domain, subdomain or single pagetarget takes a bare domain, a subdomain or a full page URL; a domain's totals include all of its subdomains, while a page URL measures the links to that page.
  • Authority and spam signals togetherrank scores the link profile from 0 to 1000, spam_score rates it from 0 to 100, and first_seen_at dates the earliest backlink found to the target.
  • Counts from link to root domainbacklinks_count, referring_pages_count, referring_domains_count and referring_main_domains_count count the links at each level, and referring_ips_count and referring_subnets_count show how many separate hosts they come from.
  • Nofollow and broken-link totalsTwo nofollow counts cover linking domains and pages that withhold ranking value, while broken_backlinks_count and broken_pages_count measure links landing on target pages that no longer load, next to crawled_pages_count.
  • Six ranked breakdownsreferring_tlds, referring_countries, link_types, link_attributes, platform_types and semantic_locations each list name and count pairs with the largest group first.

Backlinks Summary API Parameters

ParametersRequiredDescription
targetRequiredDomain, subdomain or full page URL to summarise, such as notion.so or https://example.com/blog/. A domain includes its subdomains.

How to Use the Backlinks Summary API

Send one target to the Backlinks Summary API and read a single summary row when the task finishes.

  1. POST {"target": "notion.so"} to /v1/seo/backlinks-summary and keep the task_id from the response.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the summary from results.items; the task holds one row, and results.next_cursor applies only when has_more is true.
curl -X POST "https://api.socq.ai/v1/seo/backlinks-summary" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so"}'

# Then poll GET /v1/tasks/{task_id}; one summary costs 10 credits.

Backlinks Summary API Use Cases

  • Comparing authority across a shortlist of sites: Submit each site to the Backlinks Summary API in turn and line up rank, referring_domains_count and spam_score to see which competitor, partner or acquisition target holds the stronger link profile.
  • Vetting a site before placing a link on it: Check the prospect's spam_score and compare referring_ips_count and referring_subnets_count with referring_domains_count to see whether its links come from many independent hosts.
  • Sizing link reclamation work: broken_backlinks_count and broken_pages_count show how many earned links land on dead pages, the backlog to clear with redirects or restored content.
  • Reporting where links come from: Use referring_countries, referring_tlds and platform_types to describe the geography and type of linking sites in market-entry or PR coverage reports.
  • Tracking link growth between snapshots: Store the rank, backlinks_count and referring_domains_count that the Backlinks Summary API reports, with collected_at, on a regular schedule to chart how a profile grows or shrinks.

Backlinks Summary API Pro Tips

  • To measure one subdomain on its own, pass it to the Backlinks Summary API as target, because a root domain's totals already fold in blog., shop. and every other subdomain.
  • Treat groups in referring_countries and semantic_locations whose name is empty as unknown origin or position, and leave them out when you calculate shares by country or page section.
  • Read every breakdown count as a number of backlinks, not domains, so compute percentages against backlinks_count rather than referring_domains_count.

Beyond the Backlinks Summary 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 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.
  • Referring Domains API — List the domains linking to a site or page, one row each, with authority rank, backlink and page counts, spam score and the dates each started or stopped linking.
  • 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.

Explore other platforms

Combine SEO data with public data from other supported social platforms.

Backlinks Summary API — FAQ

Backlinks Summary API is a programmatic interface for measuring the whole backlink profile of one domain, subdomain or page URL. It returns a single row with an authority rank, link and referring-domain totals, nofollow and broken-link counts, a spam score and breakdowns of the linking sites.

rank works as a domain authority score: it runs from 0 to 1000, is calculated from the target's link profile and rises with a stronger profile; read it next to spam_score, which runs from 0 to 100.

Run the same target through the Backlinks API for link-by-link rows, or through the Referring Domains API for one row per linking domain. The summary itself carries the counts and breakdowns.

Each request costs a fixed 10 credits and returns one row, however large the target's link profile is.