DataForSEO · Schema
DataForSEO Backlinks API Schemas
SEOSERPKeywordsBacklinksDomain AnalyticsOn-Page SEOCompetitor ResearchSearch EnginesContent AnalysisE-CommerceApp StoreBusiness DataAI OptimizationSocial Media
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "DataForSEO Backlinks API Schemas",
"definitions": {
"BacklinksTimeseriesNewLostSummaryLiveResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksTimeseriesNewLostSummaryLiveTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"BaseResponseInfo": {
"properties": {
"version": {
"type": "string",
"description": "the current version of the API",
"nullable": true
},
"status_code": {
"type": "integer",
"description": "general status code\nyou can find the full list of the response codes here",
"nullable": true
},
"status_message": {
"type": "string",
"description": "general informational message\nyou can find the full list of general informational messages here",
"nullable": true
},
"time": {
"type": "string",
"description": "total execution time, seconds",
"nullable": true
},
"cost": {
"type": "number",
"description": "total tasks cost, USD",
"format": "double",
"nullable": true
},
"tasks_count": {
"type": "integer",
"description": "the number of tasks in the tasks array",
"format": "int64",
"nullable": true
},
"tasks_error": {
"type": "integer",
"description": "the number of tasks in the tasks array returned with an error",
"format": "int64",
"nullable": true
}
}
},
"BacklinksTimeseriesNewLostSummaryLiveTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksTimeseriesNewLostSummaryLiveResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"BaseResponseTaskInfo": {
"properties": {
"id": {
"type": "string",
"description": "task identifier\nunique task identifier in our system in the UUID format",
"nullable": true
},
"status_code": {
"type": "integer",
"description": "status code of the task\ngenerated by DataForSEO, can be within the following range: 10000-60000\nyou can find the full list of the response codes here",
"nullable": true
},
"status_message": {
"type": "string",
"description": "informational message of the task\nyou can find the full list of general informational messages here",
"nullable": true
},
"time": {
"type": "string",
"description": "execution time, seconds",
"nullable": true
},
"cost": {
"type": "number",
"description": "total tasks cost, USD",
"format": "double",
"nullable": true
},
"result_count": {
"type": "integer",
"description": "number of elements in the result array",
"format": "int64",
"nullable": true
},
"path": {
"type": "array",
"items": {
"type": "string",
"nullable": true
},
"description": "URL path",
"nullable": true
},
"data": {
"type": "object",
"additionalProperties": {
"type": "object",
"nullable": true
},
"description": "contains the same parameters that you specified in the POST request",
"nullable": true
}
}
},
"BacklinksTimeseriesNewLostSummaryLiveResultInfo": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "target from a POST array",
"nullable": true
},
"date_from": {
"type": "string",
"description": "starting date of the time range\nin the UTC format: \u201cyyyy-mm-dd\u201d\nexample:\n2019-01-01",
"nullable": true
},
"date_to": {
"type": "string",
"description": "ending date of the time range\nin the UTC format: \"yyyy-mm-dd\"\nexample:\n\"2019-01-15\"",
"nullable": true
},
"group_range": {
"type": "string",
"description": "group_range from the POST array",
"nullable": true
},
"items_count": {
"type": "integer",
"description": "the number of results returned in the items array",
"format": "int64",
"nullable": true
},
"items": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksTimeseriesNewLostSummaryLiveItem"
}
],
"nullable": true
},
"description": "contains relevant backlinks and referring domains data",
"nullable": true
}
}
},
"BacklinksTimeseriesNewLostSummaryLiveItem": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "type of element",
"nullable": true
},
"date": {
"type": "string",
"description": "date and time when the data for the target was stored\nin the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d\nexample:\n2019-11-15 12:57:46 +00:00",
"nullable": true
},
"new_backlinks": {
"type": "integer",
"description": "number of new backlinks\nnumber of new backlinks pointing to the target",
"format": "int64",
"nullable": true
},
"lost_backlinks": {
"type": "integer",
"description": "number of lost backlinks\nnumber of lost backlinks of the target",
"format": "int64",
"nullable": true
},
"new_referring_domains": {
"type": "integer",
"description": "number of new referring domains\nnumber of new referring domains pointing to the target",
"format": "int64",
"nullable": true
},
"lost_referring_domains": {
"type": "integer",
"description": "number of lost referring domains\nnumber of lost referring domains of the target",
"format": "int64",
"nullable": true
},
"new_referring_main_domains": {
"type": "integer",
"description": "number of new referring main domains\nnumber of new referring main domains pointing to the target",
"format": "int64",
"nullable": true
},
"lost_referring_main_domains": {
"type": "integer",
"description": "number of lost referring main domains\nnumber of lost referring main domains of the target",
"format": "int64",
"nullable": true
}
}
},
"BacklinksDomainIntersectionLiveResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksDomainIntersectionLiveTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"BacklinksDomainIntersectionLiveTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksDomainIntersectionLiveResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"BacklinksDomainIntersectionLiveResultInfo": {
"type": "object",
"properties": {
"targets": {
"type": "object",
"additionalProperties": {
"type": "string",
"nullable": true
},
"description": "target domains, subdomains or webpages in a POST array",
"nullable": true
},
"total_count": {
"type": "integer",
"description": "total amount of results relevant to your request",
"format": "int64",
"nullable": true
},
"items_count": {
"type": "integer",
"description": "the number of results returned in the items array",
"format": "int64",
"nullable": true
},
"items": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksDomainIntersectionLiveItem"
}
],
"nullable": true
},
"description": "contains domain that link to all targets from the POST array",
"nullable": true
}
}
},
"BacklinksDomainIntersectionLiveItem": {
"type": "object",
"properties": {
"domain_intersection": {
"type": "object",
"additionalProperties": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksDomainIntersection"
}
],
"nullable": true
},
"description": "contains data on domains that link to the corresponding targets specified in the POST array\ndata is provided in separate objects corresponding to domains, subdomains or pages specified in the targets object",
"nullable": true
},
"summary": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/IntersectionSummaryInfo"
}
],
"description": "contains the domain intersections summary",
"nullable": true
}
}
},
"IntersectionSummaryInfo": {
"type": "object",
"properties": {
"intersections_count": {
"type": "integer",
"description": "total number of intersections",
"format": "int64",
"nullable": true
}
}
},
"BacklinksDomainIntersection": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "type of element",
"nullable": true
},
"target": {
"type": "string",
"description": "domain that links to the corresponding target from the POST array",
"nullable": true
},
"rank": {
"type": "integer",
"description": "rank referred to the target from the POST array\nindicates the rank that the referring domain (target above) refers to your target from the POST array;\nrank is calculated based on the method for node ranking in a linked database \u2013 a principle used in the original Google PageRank algorithm\nlearn more about the metric and how it is calculated in this help center article",
"nullable": true
},
"backlinks": {
"type": "integer",
"description": "indicates the number of backlinks",
"format": "int64",
"nullable": true
},
"first_seen": {
"type": "string",
"description": "date and time when our crawler found the backlink from this target for the first time\nin the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d\nexample:\n2019-11-15 12:57:46 +00:00",
"nullable": true
},
"lost_date": {
"type": "string",
"description": "date and time when the last backlink from this target was lost\nindicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed\nin the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d\nexample:\n2019-11-15 12:57:46 +00:00",
"nullable": true
},
"backlinks_spam_score": {
"type": "integer",
"description": "average spam score of the backlinks pointing to the target\nlearn more about how the metric is calculated on this help center page",
"format": "int64",
"nullable": true
},
"broken_backlinks": {
"type": "integer",
"description": "number of broken backlinks",
"format": "int64",
"nullable": true
},
"broken_pages": {
"type": "integer",
"description": "number of broken pages",
"nullable": true
},
"referring_domains": {
"type": "integer",
"description": "number of referring domains",
"format": "int64",
"nullable": true
},
"referring_domains_nofollow": {
"type": "integer",
"description": "number of domains pointing at least one nofollow link to the corresponding target",
"format": "int64",
"nullable": true
},
"referring_main_domains": {
"type": "integer",
"description": "number of referring main domains",
"format": "int64",
"nullable": true
},
"referring_main_domains_nofollow": {
"type": "integer",
"description": "number of main domains pointing at least one nofollow link to the target",
"format": "int64",
"nullable": true
},
"referring_ips": {
"type": "integer",
"description": "number of referring IP addresses",
"format": "int64",
"nullable": true
},
"referring_subnets": {
"type": "integer",
"description": "number of referring subnetworks",
"format": "int64",
"nullable": true
},
"referring_pages": {
"type": "integer",
"description": "indicates the number of pages pointing to the target",
"format": "int64",
"nullable": true
},
"referring_pages_nofollow": {
"type": "integer",
"description": "number of referring pages pointing at least one nofollow link to the target",
"format": "int64",
"nullable": true
},
"referring_links_tld": {
"type": "object",
"additionalProperties": {
"type": "integer",
"nullable": true
},
"description": "top level domains of the referring links\ncontains top-level domains and referring link count per each",
"nullable": true
},
"referring_links_types": {
"type": "object",
"additionalProperties": {
"type": "integer",
"nullable": true
},
"description": "types of the referring links\nindicates the types of referring links and link count per each type\npossible values:\nanchor, image, link, meta, canonical, alternate, redirect",
"nullable": true
},
"referring_links_attributes": {
"type": "object",
"additionalProperties": {
"type": "integer",
"nullable": true
},
"description": "link attributes of the referring links\nindicates link attributes of the referring links and the link count per each attribute",
"nullable": true
},
"referring_links_platform_types": {
"type": "object",
"additionalProperties": {
"type": "integer",
"nullable": true
},
"description": "types of referring platforms\nindicates referring platform types and link count per each platform\npossible values: cms, blogs, ecommerce, message-boards, wikis, news, organization",
"nullable": true
},
"referring_links_semantic_locations": {
"type": "object",
"additionalProperties": {
"type": "integer",
"nullable": true
},
"description": "semantic locations of the referring links\nindicates semantic elements in HTML where the referring links are located and the link count per each semantic location\nyou can get the full list of semantic elements here",
"nullable": true
},
"referring_links_countries": {
"type": "object",
"description": "ISO country codes of the referring links\nindicates ISO country codes of the domains where the referring links are located and the link count per each country",
"nullable": true
}
}
},
"BacklinksBulkBacklinksLiveResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksBulkBacklinksLiveTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"BacklinksBulkBacklinksLiveTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksBulkBacklinksLiveResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"BacklinksBulkBacklinksLiveResultInfo": {
"type": "object",
"properties": {
"items_count": {
"type": "integer",
"description": "the number of results returned in the items array",
"format": "int64",
"nullable": true
},
"items": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksBulkBacklinksLiveItem"
}
],
"nullable": true
},
"description": "contains relevant backlink data",
"nullable": true
}
}
},
"BacklinksBulkBacklinksLiveItem": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "domain, subdomain or webpage from a POST array",
"nullable": true
},
"backlinks": {
"type": "integer",
"description": "number of backlinks pointing to the target",
"format": "int64",
"nullable": true
}
}
},
"BacklinksAnchorsLiveResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksAnchorsLiveTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"BacklinksAnchorsLiveTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksAnchorsLiveResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"BacklinksAnchorsLiveResultInfo": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "target in the post array",
"nullable": true
},
"total_count": {
"type": "integer",
"description": "total number of relevant items in the database",
"format": "int64",
"nullable": true
},
"items_count": {
"type": "integer",
"description": "number of items in the results array",
"format": "int64",
"nullable": true
},
"items": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksAnchorsLiveItem"
}
],
"nullable": true
},
"description": "items array",
"nullable": true
}
}
},
"BacklinksAnchorsLiveItem": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "type of element",
"nullable": true
},
"anchor": {
"type": "string",
"description": "anchor of the backlink",
"nullable": true
},
"rank": {
"type": "integer",
"description": "rank of the anchor links\nrank volume that referring websites pass to the target through links with a particular anchor\nrank is calculated based on the method for node ranking in a linked database \u2013 a principle used in the original Google PageRank algorithm\nlearn more about the metric and how it is calculated in this help center article",
"nullable": true
},
"backlinks": {
"type": "integer",
"description": "indicates the number of backlinks",
"format": "int64",
"nullable": true
},
"first_seen": {
"type": "string",
"description": "date and time when our crawler found the backlink with this anchor for the first time\nin the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d\nexample:\n2019-11-15 12:57:46 +00:00",
"nullable": true
},
"lost_date": {
"type": "string",
"description": "date and time when the last backlink with this anchor was lost\nindicates the date and time when our crawler visited the page and it responded with 4xx or 5xx status code or the last backlink was removed\nin the UTC format: \u201cyyyy-mm-dd hh-mm-ss +00:00\u201d\nexample:\n2017-01-24 13:20:59 +00:00",
"nullable": true
},
"backlinks_spam_score": {
"type": "integer",
"description": "average spam score of all backlinks with this anchor\nlearn more about how the metric is calculated on this help center page",
"format": "int64",
"nullable": true
},
"broken_backlinks": {
"type": "integer",
"description": "number of broken backlinks\nnumber of broken backlinks pointing to the target",
"format": "int64",
"nullable": true
},
"broken_pages": {
"type": "integer",
"description": "number of broken pages\nnumber of pages that respond with 4xx or 5xx status codes where backlinks are pointing to",
"nullable": true
},
"referring_domains": {
"type": "integer",
"description": "indicates the number of referring domains",
"format": "int64",
"nullable": true
},
"referring_domains_nofollow": {
"type": "integer",
"description": "number of domains pointing at least one nofollow link to the target",
"format": "int64",
"nullable": true
},
"referring_main_domains": {
"type": "integer",
"description": "indicates the number of referring main domains",
"format": "int64",
"nullable": true
},
"referring_main_domains_nofollow": {
"type": "integer",
"description": "number of main domains pointing at least one nofollow link to the target",
"format": "int64",
"nullable": true
},
"referring_ips": {
"type": "integer",
"description": "number of referring IP addresses\nnumber of IP addresses pointing to this page",
"format": "int64",
"nullable": true
},
"referring_subnets": {
"type": "integer",
"description": "number of referring subnetworks",
"format": "int64",
"nullable": true
},
"referring_pages": {
"type": "integer",
"description": "indicates the number of pages pointing to target with this anchor",
"format": "int64",
"nullable": true
},
"referring_pages_nofollow": {
"type": "integer",
"description": "number of referring pages pointing at least one nofollow link to the target with this anchor",
"format": "int64",
"nullable": true
},
"referring_links_tld": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "top-level domains of the referring links\ncontains top level domains and referring link count per each",
"nullable": true
},
"referring_links_types": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "types of referring links\nindicates the types of the referring links and link count per each type\npossible values:\nanchor, image, link, meta, canonical, alternate, redirect",
"nullable": true
},
"referring_links_attributes": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "link attributes of the referring links\nindicates link attributes of the referring links and link count per each attribute",
"nullable": true
},
"referring_links_platform_types": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "types of referring platforms\nindicates referring platform types and and link count per each platform\npossible values: cms, blogs, ecommerce, message-boards, wikis, news, organization",
"nullable": true
},
"referring_links_semantic_locations": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "semantic locations of the referring links\nindicates semantic elements in HTML where the referring links are located and link count per each semantic location\nyou can get the full list of semantic elements here\nexamples:\narticle, section, summary",
"nullable": true
},
"referring_links_countries": {
"type": "object",
"additionalProperties": {
"type": "integer",
"format": "int64",
"nullable": true
},
"description": "ISO country codes of the referring links\nindicates ISO country codes of the domains where the referring links are located and the link count per each country",
"nullable": true
}
}
},
"BacklinksHistoryLiveResponseInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksHistoryLiveTaskInfo"
}
],
"nullable": true
},
"description": "array of tasks",
"nullable": true
}
}
}
]
},
"BacklinksHistoryLiveTaskInfo": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksHistoryLiveResultInfo"
}
],
"nullable": true
},
"description": "array of results",
"nullable": true
}
}
}
]
},
"BacklinksHistoryLiveResultInfo": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "target from the POST array",
"nullable": true
},
"date_from": {
"type": "string",
"description": "starting date of the time range\nin the UTC format: \u201cyyyy-mm-dd\u201d\nexample:\n2019-01-01",
"nullable": true
},
"date_to": {
"type": "string",
"description": "ending date of the time range\nin the UTC format: \"yyyy-mm-dd\"\nexample:\n\"2019-01-15\"",
"nullable": true
},
"items_count": {
"type": "integer",
"description": "the number of results returned in the items array",
"format": "int64",
"nullable": true
},
"items": {
"type": "array",
"items": {
"type": "object",
"oneOf": [
{
"$ref": "#/components/schemas/BacklinksHistoryLiveItem"
}
],
"nullable": true
},
"description": "contains historical backlink data for the specified domain\nthe data is provided month-by-month;\nthe metrics are aggregated according to the backlinks the specified domain had
# --- truncated at 32 KB (259 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/json-schema/dataforseo-backlinks-schema.json