seo/
backlinks

The Backlinks API lists the links to a domain, subdomain or page, strongest first, with linking page, anchor text, dofollow status, authority and spam scores, and first and last seen dates.

Backlinks API

Up to 1,000 links
Strongest links first
Anchor and dofollow data
10 credits / request + 0.02 credits / result
Ready
README

By SocQ · Updated

Backlinks

A backlink is one link from a page on another site to a domain or page, described by the linking page and its title, the landing URL, the anchor text, dofollow status and rel attributes, authority scores for the link, the page and the domain, a spam score, its position on the page and the dates it was first and last seen. Listed one by one, these links show which pages and anchors earn a site its authority, so they feed anchor text audits, competitor link mining, outreach lists and the monitoring of new, lost and broken links.

Backlinks API Features

  • Every link, strongest firstThe Backlinks API returns the individual backlinks of a domain, subdomain or page URL ordered from the strongest down, from 1 to 1,000 per request through results_limit.
  • Both ends of each linksource_url, source_domain and source_title identify the linking page, language gives its language code, and target_url shows exactly which page on the target receives the link.
  • Anchor, markup and placementanchor holds the link text, link_type tells an anchor from an image, redirect or canonical link, is_dofollow and attributes carry the rel values, and semantic_location places the link in an article, nav or footer.
  • Authority at three levelsrank scores the link itself, source_page_rank and source_domain_rank score the page and site it sits on, all from 0 to 1000, with spam_score from 0 to 100 alongside.
  • Link lifecycle flags and datesis_new, is_lost and is_broken mark links found since the previous crawl, links removed from their page and links pointing to pages that no longer load, framed by first_seen_at and last_seen_at.

Backlinks API Parameters

ParametersRequiredDescription
targetRequiredDomain, subdomain or full page URL whose backlinks you want, such as notion.so or https://example.com/blog/post.
results_limitOptionalNumber of backlinks to return, an integer from 1 to 1000; defaults to 100. The strongest links are returned first.

How to Use the Backlinks API

Send the Backlinks API a target and the number of links you want, then page through the link rows.

  1. POST {"target": "notion.so", "results_limit": 100} to /v1/seo/backlinks.
  2. Poll GET /v1/tasks/{task_id} with the returned task_id until status is succeeded.
  3. Read the links from results.items, and keep requesting with results.next_cursor while has_more is true until every link has been loaded.
curl -X POST "https://api.socq.ai/v1/seo/backlinks" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","results_limit":100}'

# 10 credits per request plus 0.02 per backlink returned.

Backlinks API Use Cases

  • Auditing anchor text: Group rows by anchor to see how much of a profile uses brand names, bare URLs or keyword phrases, and check is_dofollow on the keyword-rich ones.
  • Mining a competitor's strongest links: Run a competitor's domain through the Backlinks API and take the top rows by rank, with source_domain and source_title, as a shortlist of publications worth pitching.
  • Finding the pages that attract links: Count rows per target_url on your own domain to learn which articles, tools or landing pages earn backlinks and deserve updates or internal links.
  • Watching for new and lost links: Filter is_new and is_lost, with last_seen_at, to report the links a site gained and lost and to follow up on removed placements.
  • Redirecting broken link targets: Rows with is_broken set list the target_url values that now fail, so each dead page can be redirected and its incoming links recovered.

Backlinks API Pro Tips

  • Use id as the key when you store links from the Backlinks API across runs, since it is built from the linking page, the linked page and the anchor and stays the same for the same link.
  • Expect several rows from one source_domain, because every link is listed separately; group by source_domain, or switch to the Referring Domains API, when you need one row per site.
  • Exclude rows where is_lost is true before you count live links, since links that have disappeared from their page can still be listed with that flag.
  • Keep results_limit at the depth you will actually review: the list starts with the strongest links, so a smaller limit trims the weakest ones and the per-link charge.

Beyond the Backlinks 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.
  • 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 API — FAQ

Backlinks API is a programmatic interface for listing the individual links that point to a domain, subdomain or page URL. It returns each link's source page and title, landing URL, anchor text, dofollow status and rel attributes, authority and spam scores, placement and first and last seen dates.

Up to 1,000. results_limit defaults to 100 and accepts any integer from 1 to 1,000, and the links arrive strongest first.

Put the full page URL in target to get the links pointing to that one page, or use the bare domain to cover the whole site.

is_dofollow is true when a link passes ranking value, and attributes lists rel values such as nofollow, ugc or sponsored for a closer look.

Each request costs 10 credits plus 0.02 credits per backlink returned, so 100 links cost 12 credits and 1,000 links cost 30. The 10-credit base covers the lookup itself.