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
| Parameters | Required | Description |
|---|---|---|
target | Required | Domain, 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.
- POST {"target": "notion.so"} to /v1/seo/backlinks-summary and keep the task_id from the response.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.
- 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