The Backlinks API from DataForSEO — 24 operation(s) for backlinks.
openapi: 3.0.1
info:
title: DataForSEO AiOptimization 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:
- name: Backlinks
paths:
/v3/backlinks/id_list:
post:
tags:
- Backlinks
description: 'This endpoint is designed to provide you with a list of IDs and metadata for all Backlinks tasks created within the specified time period, including both successful and uncompleted tasks.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/id_list/?bash'''
operationId: BacklinksIdList
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksIdListRequestInfo'
nullable: true
example:
- datetime_from: '2026-04-12 04:39:39 +00:00'
datetime_to: '2026-04-14 04:39:39 +00:00'
limit: 100
offset: 0
sort: desc
include_metadata: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksIdListResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/errors:
post:
tags:
- Backlinks
description: 'By calling this endpoint you will receive information about the Backlinks API tasks that returned an error within the past 7 days.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/errors/?bash'''
operationId: BacklinksErrors
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksErrorsRequestInfo'
nullable: true
example:
- limit: 10
offset: 0
filtered_function: backlinks/content_duplicates
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksErrorsResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/available_filters:
get:
tags:
- Backlinks
description: 'Backlinks API features plenty of parameters that support custom filtration. By applying filters to your POST requests, you will be able to effortlessly extract data that matches your requirements. Note that we do not charge any fees for using data filtering or sorting rules.
Here you will find all the necessary information about filters that can be used with DataForSEO Backlinks API endpoints.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/filters/?bash'''
operationId: BacklinksAvailableFilters
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksAvailableFiltersResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/index:
get:
tags:
- Backlinks
description: 'This endpoint will provide you with the total number of backlinks, domains, and pages our database contains for the moment when you make a request. You will also get stats for the last 12 months.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/index/?bash'''
operationId: Index
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksIndexResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/summary/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with an overview of backlinks data available for a given domain, subdomain, or webpage.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/summary/live/?bash'''
operationId: SummaryLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksSummaryLiveRequestInfo'
nullable: true
example:
- target: explodingtopics.com
internal_list_limit: 10
include_subdomains: true
backlinks_filters:
- dofollow
- '='
- true
backlinks_status_type: all
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksSummaryLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/history/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with historical backlinks data back to the beginning of 2019. You can receive the number of backlinks a given domain had in a specific time period, the number of new & lost backlinks, referring domains, and more.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/history/live/?bash'''
operationId: HistoryLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksHistoryLiveRequestInfo'
nullable: true
example:
- target: cnn.com
date_from: '2026-01-15'
date_to: '2026-03-15'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksHistoryLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/backlinks/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with a list of backlinks and relevant data for the specified domain, subdomain, or webpage.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/backlinks/live/?bash'''
operationId: BacklinksLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBacklinksLiveRequestInfo'
nullable: true
example:
- target: forbes.com
mode: as_is
filters:
- dofollow
- '='
- true
limit: 5
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBacklinksLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/anchors/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with a detailed overview of anchors used when linking to the specified website with relevant backlink data for each of them.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/anchors/live/?bash'''
operationId: AnchorsLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksAnchorsLiveRequestInfo'
nullable: true
example:
- target: forbes.com
limit: 4
order_by:
- backlinks,desc
filters:
- anchor
- like
- '%news%'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksAnchorsLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/domain_pages/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with a detailed overview of domain pages with backlink data for each page.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/domain_pages/live/?bash'''
operationId: DomainPagesLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksDomainPagesLiveRequestInfo'
nullable: true
example:
- target: forbes.com
limit: 5
filters:
- - page_summary.backlinks
- '>'
- 5
- and
- - page
- like
- '%sites%'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksDomainPagesLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/domain_pages_summary/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with detailed summary data on all backlinks and related metrics for each page of the target domain or subdomain you specify. If you indicate a single page as a target, you will get comprehensive summary data on all backlinks for that page.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/domain_pages_summary/live/?bash'''
operationId: DomainPagesSummaryLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksDomainPagesSummaryLiveRequestInfo'
nullable: true
example:
- target: forbes.com
limit: 4
order_by:
- backlinks,desc
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksDomainPagesSummaryLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/referring_domains/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with a detailed overview of referring domains pointing to the target you specify.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/referring_domains/live/?bash'''
operationId: ReferringDomainsLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksReferringDomainsLiveRequestInfo'
nullable: true
example:
- target: backlinko.com
limit: 5
order_by:
- rank,desc
exclude_internal_backlinks: true
backlinks_filters:
- dofollow
- '='
- true
filters:
- backlinks
- '>'
- 100
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksReferringDomainsLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/referring_networks/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with a detailed overview of referring IPs and subnets pointing to the target you specify.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/referring_networks/live/?bash'''
operationId: ReferringNetworksLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksReferringNetworksLiveRequestInfo'
nullable: true
example:
- target: backlinko.com
network_address_type: subnet
limit: 5
order_by:
- rank,desc
exclude_internal_backlinks: true
backlinks_filters:
- dofollow
- '='
- true
filters:
- backlinks
- '>'
- 100
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksReferringNetworksLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/competitors/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with a list of competitors that share some part of the backlink profile with a target website, along with a number of backlink intersections and the rank of every competing website.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/competitors/live/?bash'''
operationId: CompetitorsLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksCompetitorsLiveRequestInfo'
nullable: true
example:
- target: dataforseo.com
filters:
- rank
- '>'
- 100
order_by:
- rank,desc
limit: 5
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksCompetitorsLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/domain_intersection/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with the list of domains pointing to the specified websites. This endpoint is especially useful for creating a Link Gap feature that shows what domains link to your competitors but do not link out to your website.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/domain_intersection/live/?bash'''
operationId: DomainIntersectionLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksDomainIntersectionLiveRequestInfo'
nullable: true
example:
- targets:
'1': moz.com
'2': ahrefs.com
include_subdomains: false
exclude_targets:
- semrush.com
limit: 5
order_by:
- 1.backlinks,desc
exclude_internal_backlinks: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksDomainIntersectionLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/page_intersection/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with the list of referring pages pointing to the specified targets. It is especially useful for finding the backlinks that point to your competitors but don’t point to your website.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/page_intersection/live/?bash'''
operationId: PageIntersectionLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksPageIntersectionLiveRequestInfo'
nullable: true
example:
- targets:
'1': football.com
'2': fifa.com
exclude_targets:
- skysports.com
limit: 5
order_by:
- 1.rank,desc
filters:
- - 2.domain_from_rank
- '>'
- 400
- and
- - 1.dofollow
- '='
- true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksPageIntersectionLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/timeseries_summary/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with an overview of backlink data for the target domain available during a period between the two indicated dates. Backlink metrics will be grouped by the time range that you define: day, week, month, or year.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/timeseries_summary/live/?bash'''
operationId: TimeseriesSummaryLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksTimeseriesSummaryLiveRequestInfo'
nullable: true
example:
- target: dataforseo.com
date_from: '2026-01-15'
date_to: '2026-03-15'
group_range: month
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksTimeseriesSummaryLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/timeseries_new_lost_summary/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with the number of new and lost backlinks and referring domains for the domain specified in the target field.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/timeseries_new_lost_summary/live/?bash'''
operationId: TimeseriesNewLostSummaryLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksTimeseriesNewLostSummaryLiveRequestInfo'
nullable: true
example:
- target: dataforseo.com
date_from: '2026-01-15'
date_to: '2026-03-15'
group_range: month
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksTimeseriesNewLostSummaryLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/bulk_ranks/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with rank scores of the domains, subdomains, and pages specified in the targets array. The score is based on the number of referring domains pointing to the specified domains, subdomains, or pages. The rank values represent real-time data for the date of the request and range from 0 (no backlinks detected) to 1,000 (highest rank). A similar scoring system is used in Google’s Page Rank algorithm. You can learn more about rank scores in this help center article
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/bulk_ranks/live/?bash'''
operationId: BulkRanksLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkRanksLiveRequestInfo'
nullable: true
example:
- targets:
- forbes.com
- cnn.com
- bbc.com
- yelp.com
- https://www.apple.com/iphone/
- https://ahrefs.com/blog/
- ibm.com
- https://variety.com/
- https://stackoverflow.com/
- www.trustpilot.com
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkRanksLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/bulk_backlinks/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with the number of backlinks pointing to domains, subdomains, and pages specified in the targets array. The returned numbers correspond to all live backlinks, that is, total number of referring links with all attributes (e.g., nofollow, noreferrer, ugc, sponsored etc) that were found during the latest check.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/bulk_backlinks/live/?bash'''
operationId: BulkBacklinksLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkBacklinksLiveRequestInfo'
nullable: true
example:
- targets:
- forbes.com
- cnn.com
- bbc.com
- yelp.com
- https://www.apple.com/iphone/
- https://ahrefs.com/blog/
- ibm.com
- https://variety.com/
- https://stackoverflow.com/
- www.trustpilot.com
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkBacklinksLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/bulk_spam_score/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with spam scores of the domains, subdomains, and pages you specified in the targets array. Spam Score is DataForSEO’s proprietary metric that indicates how “spammy” your target is on a scale from 0 to 100. You can learn more about Spam Score, how it is calculated, and signals it takes into account in this help center article
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/bulk_spam_score/live/?bash'''
operationId: BulkSpamScoreLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkSpamScoreLiveRequestInfo'
nullable: true
example:
- targets:
- forbes.com
- cnn.com
- bbc.com
- yelp.com
- https://www.apple.com/iphone/
- https://ahrefs.com/blog/
- ibm.com
- https://variety.com/
- https://stackoverflow.com/
- www.trustpilot.com
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkSpamScoreLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/bulk_referring_domains/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with the number of referring domains pointing to domains, subdomains, and pages specified in the targets array. The returned numbers are based on all live referring domains, that is, total number of domains pointing to the target with any type of backlinks (e.g., nofollow, noreferrer, ugc, sponsored etc) that were found during the latest check.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/bulk_referring_domains/live/?bash'''
operationId: BulkReferringDomainsLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkReferringDomainsLiveRequestInfo'
nullable: true
example:
- targets:
- forbes.com
- cnn.com
- bbc.com
- yelp.com
- https://www.apple.com/iphone/
- https://ahrefs.com/blog/
- ibm.com
- https://variety.com/
- https://stackoverflow.com/
- www.trustpilot.com
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkReferringDomainsLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/bulk_new_lost_backlinks/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with the number of new and lost backlinks for the domains, subdomains, and pages specified in the targets array.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/bulk_new_lost_backlinks/live/?bash'''
operationId: BulkNewLostBacklinksLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkNewLostBacklinksLiveRequestInfo'
nullable: true
example:
- targets:
- forbes.com
- cnn.com
- bbc.com
- yelp.com
- https://www.apple.com/iphone/
- https://ahrefs.com/blog/
- ibm.com
- https://variety.com/
- https://stackoverflow.com/
- www.trustpilot.com
date_from: '2026-01-15'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkNewLostBacklinksLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/bulk_new_lost_referring_domains/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with the number of referring domains pointing to the domains, subdomains and pages specified in the targets array.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/bulk_new_lost_referring_domains/live/?bash'''
operationId: BulkNewLostReferringDomainsLive
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkNewLostReferringDomainsLiveRequestInfo'
nullable: true
example:
- targets:
- forbes.com
- cnn.com
- bbc.com
- yelp.com
- https://www.apple.com/iphone/
- https://ahrefs.com/blog/
- ibm.com
- https://variety.com/
- https://stackoverflow.com/
- www.trustpilot.com
date_from: '2026-01-15'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BacklinksBulkNewLostReferringDomainsLiveResponseInfo'
nullable: true
security:
- basicAuth: []
/v3/backlinks/bulk_pages_summary/live:
post:
tags:
- Backlinks
description: 'This endpoint will provide you with a comprehensive overview of backlinks and related data for a bulk of up to 1000 pages, domains, or subdomains. If you indicate a single page as a target, you will get comprehensive summary data on all backlinks for that page.
for more info please visit ''https://docs.dataforseo.com/v3/backlinks/bulk_pages_summary/live/?bash'''
operationId: BulkPagesSummaryLive
requestBody:
content:
applicati
# --- truncated at 32 KB (268 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-backlinks-api-openapi.yml