DataForSEO

DataForSEO Backlinks API

The Backlinks API from DataForSEO — 24 operation(s) for backlinks.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 24

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v3/backlinks/id_list List IDs of Backlinks tasks in a time period · Backlinks id list #
Ask an LLM
“Can I get the IDs of every Backlinks task I created during a given time window?”
“Which Backlinks tasks did I run last week, including ones that didn't complete?”
Tell an agent
List the IDs and metadata of all Backlinks tasks I created this month.
Pull every Backlinks task ID from my account for yesterday, successful or not.
POST /v3/backlinks/errors List Backlinks tasks that failed recently · Backlinks errors #
Ask an LLM
“Which of my Backlinks API calls returned an error in the past seven days?”
“Why did some of my backlink requests fail this week?”
Tell an agent
Show the Backlinks API tasks that errored in the last 7 days.
Get the error details for my failed backlink requests this week.
GET /v3/backlinks/available_filters List filters usable in Backlinks requests · Backlinks available filters #
Ask an LLM
“What fields can I filter and sort on when pulling backlink data?”
“Do filtering or sorting rules on backlink requests cost extra?”
Tell an agent
Get the list of filters supported by the Backlinks endpoints.
Show which backlink fields I can use in filter expressions.
GET /v3/backlinks/index Get the size of the backlinks database · Index #
Ask an LLM
“How many backlinks, domains and pages does the DataForSEO index hold right now?”
“How has the backlink database grown over the last 12 months?”
Tell an agent
Report the current total of backlinks, domains and pages in the index.
Show the backlink index growth stats for the past year.
POST /v3/backlinks/summary/live Get a backlink profile overview for a target · Summary live #
Ask an LLM
“What does the overall backlink profile of a domain look like at a glance?”
“Can I get a single summary of backlinks for one webpage or subdomain?”
Tell an agent
Give me a backlink summary for my domain.
Summarize the backlink profile of this subdomain in one overview.
POST /v3/backlinks/history/live Get historical backlink data for a domain · History live #
Ask an LLM
“How many backlinks did my domain have back in 2019 compared with today?”
“Can I see how my backlinks and referring domains changed over the years?”
Tell an agent
Pull the historical backlink counts for my domain since 2019.
Show the long-term history of new and lost backlinks for this domain.
POST /v3/backlinks/backlinks/live List the backlinks pointing to a target · Backlinks live #
Ask an LLM
“Which individual links point to my website?”
“Can I get the full list of backlinks to a specific page, not just counts?”
Tell an agent
List every backlink pointing to my domain with its link data.
Get the individual backlinks to this webpage.
POST /v3/backlinks/anchors/live Analyze anchor texts linking to a site · Anchors live #
Ask an LLM
“What anchor text do other sites use when they link to me?”
“Which anchors bring the most backlinks to a website?”
Tell an agent
Break down the anchor texts used in links to my site.
Show the anchor text distribution with backlink data for this website.
POST /v3/backlinks/domain_pages/live List a domain's pages with their backlink data · Domain pages live #
Ask an LLM
“Which pages on my domain are attracting backlinks?”
“Can I see the pages of a site along with backlink data for each one?”
Tell an agent
List the pages of my domain with backlink data for each.
Show which pages on this site have the most links.
POST /v3/backlinks/domain_pages_summary/live Summarize backlink metrics per page of a domain · Domain pages summary live #
Ask an LLM
“What are the summarized backlink metrics for each page on a domain?”
“Can I get per-page backlink summaries rather than raw page lists?”
Tell an agent
Give me backlink summary metrics for each page on my domain.
Produce a per-page backlink metrics rollup for this subdomain.
POST /v3/backlinks/referring_domains/live List the referring domains for a target · Referring domains live #
Ask an LLM
“Which domains link to my website?”
“What are the referring domains for a page, with details on each?”
Tell an agent
List the referring domains pointing to my site.
Show the detailed referring domain breakdown for this target.
POST /v3/backlinks/referring_networks/live List referring IPs and subnets for a target · Referring networks live #
Ask an LLM
“Which IP addresses and subnets do my backlinks come from?”
“Are many of a site's links coming from the same network?”
Tell an agent
Show the referring IPs and subnets linking to my domain.
Break down this target's backlinks by referring network.
POST /v3/backlinks/competitors/live Find sites sharing a backlink profile · Competitors live #
Ask an LLM
“Which websites share the most backlinks with mine?”
“Who are my link-building competitors and how do they rank?”
Tell an agent
Find competitors that overlap with my domain's backlink profile.
List sites sharing backlinks with this website, with their intersection counts and rank.
POST /v3/backlinks/domain_intersection/live Find domains linking to competitors but not you · Domain intersection live #
Ask an LLM
“Which domains link to my competitors but not to my site?”
“Can I build a link gap report at the domain level?”
Tell an agent
Run a domain-level link gap between my site and two competitors.
List referring domains that point to all of these websites.
POST /v3/backlinks/page_intersection/live Find pages linking to competitors but not you · Page intersection live #
Ask an LLM
“Which specific referring pages link to my competitors but not to me?”
“Can I find link opportunities at the page level rather than the domain level?”
Tell an agent
Find the referring pages that link to my competitors and not my site.
Run a page-level backlink intersection across these targets.
POST /v3/backlinks/timeseries_summary/live Get backlink metrics over a date range · Timeseries summary live #
Ask an LLM
“How did my backlink metrics trend between two dates, grouped by week or month?”
“Can I chart a domain's backlink data day by day for a custom period?”
Tell an agent
Chart my domain's backlink metrics month by month for this year.
Get weekly backlink summary data for this domain between two dates.
POST /v3/backlinks/timeseries_new_lost_summary/live Track new and lost backlinks for a domain over time · Timeseries new lost summary live #
Ask an LLM
“How many backlinks and referring domains did my domain gain and lose over time?”
“When did a site lose a big chunk of its links?”
Tell an agent
Show new versus lost backlinks and referring domains for my domain over time.
Plot the gained and lost links timeline for this domain.
POST /v3/backlinks/bulk_ranks/live Get rank scores for many targets at once · Bulk ranks live #
Ask an LLM
“What is the 0 to 1,000 rank score of each domain in my list?”
“Can I compare authority ranks for a batch of pages in one request?”
Tell an agent
Get rank scores for this list of domains.
Compare the backlink rank of these pages and subdomains in bulk.
POST /v3/backlinks/bulk_backlinks/live Count backlinks for many targets at once · Bulk backlinks live #
Ask an LLM
“How many live backlinks does each site in my list have?”
“Can I get total backlink counts for a batch of URLs in one call?”
Tell an agent
Count the live backlinks for each of these domains.
Get bulk backlink totals for this list of pages.
POST /v3/backlinks/bulk_spam_score/live Get spam scores for many targets at once · Bulk spam score live #
Ask an LLM
“How spammy are the domains in my outreach list on a 0 to 100 scale?”
“Can I check spam scores for a batch of pages before linking to them?”
Tell an agent
Score these domains for spam.
Get the spam score of each URL in this list.
POST /v3/backlinks/bulk_referring_domains/live Count referring domains for many targets · Bulk referring domains live #
Ask an LLM
“How many referring domains does each site in my list have?”
“Can I compare the number of linking domains across a batch of competitors?”
Tell an agent
Count referring domains for each of these targets.
Get bulk referring domain totals for this list of competitor sites.
POST /v3/backlinks/bulk_new_lost_backlinks/live Count new and lost backlinks for many targets · Bulk new lost backlinks live #
Ask an LLM
“How many backlinks did each site in my list gain or lose recently?”
“Can I check new and lost link counts for a batch of pages at once?”
Tell an agent
Get new and lost backlink counts for each of these domains.
Compare recent backlink gains and losses across this list of URLs.
POST /v3/backlinks/bulk_new_lost_referring_domains/live Count new and lost referring domains in bulk · Bulk new lost referring domains live #
Ask an LLM
“How many linking domains did each site in my list gain or lose?”
“Which of my competitors lost referring domains recently?”
Tell an agent
Get new and lost referring domain counts for each of these sites.
Check referring domain gains and losses across this batch of targets.
POST /v3/backlinks/bulk_pages_summary/live Summarize backlinks for up to 1,000 targets · Bulk pages summary live #
Ask an LLM
“Can I get full backlink summaries for up to a thousand pages in one request?”
“What is the most efficient way to audit backlinks for a large list of URLs?”
Tell an agent
Produce a backlink summary for each URL in this list of pages.
Run a bulk backlink overview across these domains and subdomains.

Documentation

📖
Documentation
https://docs.dataforseo.com/v3/backlinks/overview/
📖
APIReference
https://docs.dataforseo.com/v3/backlinks/overview/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-backlinks-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/json-schema/dataforseo-backlinks-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/overlays/dataforseo-backlinks-overlay.yaml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/examples/dataforseo-backlinks-examples.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dataforseo:dataforseo-backlinks-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dataforseo-backlinks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: DataForSEO Backlinks API
  description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
  version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:


# --- truncated at 32 KB (276 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-backlinks-api-openapi.yml