Your account will be charged for each request.
The cost can be calculated on the Pricing page.
Domain Pages
This endpoint will provide you with a detailed overview of domain pages with backlink data for each page.
This endpoint will provide you with a detailed overview of domain pages with backlink data for each page.
Your account will be charged for each request.
The cost can be calculated on the Pricing page.
All POST data should be sent in the JSON format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array. You can send up to 2000 API calls per minute, each Live API call can contain only one task. The maximum number of calls that can be sent simultaneously is limited to 30.
Description of the fields for setting a task:
| Field name | Type | Description |
|---|---|---|
target | string | domain or subdomain |
limit | integer | the maximum number of returned pages |
offset | integer | offset in the results array of returned pages |
internal_list_limit | integer | maximum number of elements within internal arrays default value: |
backlinks_status_type | string | set what backlinks to return and count default value: |
filters | array | array of results filtering parameters
The full list of possible filters is available here. |
order_by | array | results sorting rules |
backlinks_filters | array | filter the backlinks of your |
include_subdomains | boolean | indicates if the subdomains of the |
exclude_internal_backlinks | boolean | indicates if internal backlinks from subdomains to the |
rank_scale | string | defines the scale used for calculating and displaying the you can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scale possible values: default value: learn more about how this parameter works and how ranking metrics are calculated in this Help Center article |
tag | string | user-defined task identifier |
tasks array with the information specific to the set tasks.
Description of the fields in the results array:
| Field name | Type | Description |
|---|---|---|
version | string | the current version of the API |
status_code | integer | general status code |
status_message | string | general informational message |
time | string | execution time, seconds |
cost | float | total tasks cost, USD |
tasks_count | integer | the number of tasks in the |
tasks_error | integer | the number of tasks in the |
tasks | array | array of tasks |
id | string | task identifier |
status_code | integer | status code of the task |
status_message | string | informational message of the task |
time | string | execution time, seconds |
cost | float | cost of the task, USD |
result_count | integer | number of elements in the |
path | array | URL path |
data | object | contains the same parameters that you specified in the POST request |
result | array | array of results |
target | string |
|
total_count | integer | total number of relevant items in the database |
items_count | integer | number of items in the |
items | array | items array |
type | string | type of element='backlinks_domain_page'n |
main_domain | string | main website domain |
domain | string | domain |
tld | string | top-level domain |
page | string | page URL |
ip | string | Internet Protocol address |
first_visited | string | date and time of the first page visit |
prev_visited | string | previous to the most recent date when our crawler visited the page |
fetch_time | string | most recent date and time when our crawler visited the page |
status code | integer | HTTP status code of the page |
location | string | location header |
size | integer | indicates the page size, in bytes |
encoded_size | integer | page size after encoding |
content_encoding | string | type of encoding |
media_type | string | types of media used to display a page |
server | string | server version |
meta | object | page meta data |
title | string | page title |
canonical | string | canonical page |
internal_links_count | integer | number of internal links on the page |
external_links_count | integer | number of external links on the page |
images_count | integer | number of images on the page |
words_count | integer | number of words on the page |
page_spam_score | integer | spam score of the page |
social_media_tags | object | array of social media tags found on the page |
h1 | array | h1 tag |
h2 | array | h2 tag |
h3 | array | h3 tag |
images_alt | array | content of |
powered_by | array | CMS details |
language | string | page content language |
charset | string | character encoding |
platform_type | array | type of a platform |
technologies | object | website technologies |
cms | string | content management system |
blogs | string | blog management system |
cdn | string | content delivery network |
page_summary | object | contains backlink data for this page |
first_seen | string | date and time when our crawler found the backlink for the first time |
lost_date | string | date and time when the last backlink for this page was lost |
rank | integer | page rank |
backlinks | integer | indicates the number of backlinks |
backlinks_spam_score | integer | average spam score of the backlinks pointing to the page |
broken_backlinks | integer | number of broken backlinks |
broken_pages | integer | number of broken pages |
referring_domains | integer | indicates the number of referring domains |
referring_domains_nofollow | integer | number of domains pointing at least one nofollow link to the |
referring_main_domains | integer | indicates the number of referring main domains |
referring_main_domains_nofollow | integer | number of main domains pointing at least one nofollow link to the |
referring ips | integer | number of referring IP addresses |
referring subnets | integer | number of referring subnetworks |
referring_pages | integer | indicates the number of pages pointing to the |
referring_links_tld | object | top-level domains of the referring links |
referring_links_types | object | types of referring links |
referring_links_attributes | object | link attributes of the referring links |
referring_links_platform_types | object | types of referring platforms possible values: |
referring_links_semantic_locations | object | semantic locations of the referring links you can get the full list of semantic elements here |
referring_links_countries | object | ISO country codes of the referring links |
referring_pages_nofollow | integer | number of referring pages pointing at least one nofollow link to the |
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
login="login"
password="password"
cred="$(printf ${login}:${password} | base64)"
curl --location --request POST "https://api.dataforseo.com/v3/backlinks/domain_pages/live"
--header "Authorization: Basic ${cred}"
--header "Content-Type: application/json"
--data-raw '[
{
"target": "forbes.com",
"limit": 5,
"filters": [
["page_summary.backlinks", ">", 5],
"and",
["page", "like", "%sites%"]
]
}
]'<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
$client = new RestClient($api_url, null, 'login', 'password');
$post_array = array();
// simple way to get a result
$post_array[] = array(
"target" => "forbes.com",
"filters" => [
["page_summary.backlinks", ">", 5],
"and",
["page", "like", "%sites%"]
],
"limit" => 5
);
try {
// POST /v3/backlinks/domain_pages/live
// the full list of possible parameters is available in documentation
$result = $client->post('/v3/backlinks/domain_pages/live', $post_array);
print_r($result);
// do something with post result
} catch (RestClientException $e) {
echo "n";
print "HTTP code: {$e->getHttpCode()}n";
print "Error code: {$e->getCode()}n";
print "Message: {$e->getMessage()}n";
print $e->getTraceAsString();
echo "n";
}
$client = null;
?>const post_array = [];
post_array.push({
"target": "forbes.com",
"limit": 5,
"filters": [
["page_summary.backlinks", ">", 5],
"and",
["page", "like", "%sites%"]
]
});
const axios = require('axios');
axios({
method: 'post',
url: 'https://api.dataforseo.com/v3/backlinks/backlinks/live',
auth: {
username: 'login',
password: 'password'
},
data: post_array,
headers: {
'content-type': 'application/json'
}
}).then(function (response) {
var result = response['data']['tasks'];
// Result data
console.log(result);
}).catch(function (error) {
console.log(error);
});from client import RestClient
# You can download this file from here https://api.dataforseo.com/v3/_examples/python/_python_Client.zip
client = RestClient("login", "password")
post_data = dict()
# simple way to set a task
post_data[len(post_data)] = dict(
target="forbes.com",
filters=[
["page_summary.backlinks", ">", 5],
"and",
["page", "like", "%sites%"]
],
limit=5
)
# POST /v3/backlinks/domain_pages/live
# the full list of possible parameters is available in documentation
response = client.post("/v3/backlinks/domain_pages/live", post_data)
# you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if response["status_code"] == 20000:
print(response)
# do something with result
else:
print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace DataForSeoDemos
{
public static partial class Demos
{
public static async Task backlinks_domain_pages_live()
{
var httpClient = new HttpClient
{
BaseAddress = new Uri("https://api.dataforseo.com/"),
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
};
var postData = new List<object>();
// simple way to get a result
postData.Add(new
{
target = "forbes.com",
filters = new object[]
{
new object[] { "page_summary.backlinks", ">", 5 },
"and",
new object[] { "page", "like", "%sites%" }
},
limit = 5
});
// POST /v3/backlinks/domain_pages/live
// the full list of possible parameters is available in documentation
var taskPostResponse = await httpClient.PostAsync("/v3/backlinks/domain_pages/live", new StringContent(JsonConvert.SerializeObject(postData)));
var result = JsonConvert.DeserializeObject<dynamic>(await taskPostResponse.Content.ReadAsStringAsync());
// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
if (result.status_code == 20000)
{
// do something with result
Console.WriteLine(result);
}
else
Console.WriteLine($"error. Code: {result.status_code} Message: {result.status_message}");
}
}
}The above command returns JSON structured like this:
{
"version": "0.1.20230825",
"status_code": 20000,
"status_message": "Ok.",
"time": "2.5415 sec.",
"cost": 0.02015,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "09291851-1535-0270-0000-1c4a85cd651c",
"status_code": 20000,
"status_message": "Ok.",
"time": "2.4869 sec.",
"cost": 0.02015,
"result_count": 1,
"path": [
"v3",
"backlinks",
"domain_pages",
"live"
],
"data": {
"api": "backlinks",
"function": "domain_pages",
"target": "forbes.com",
"limit": 5,
"filters": [
[
"page_summary.backlinks",
">",
5
],
"and",
[
"page",
"like",
"%sites%"
]
]
},
"result": [
{
"target": "forbes.com",
"total_count": 350709,
"items_count": 5,
"items": [
{
"type": "backlinks_domain_page",
"main_domain": "forbes.com",
"domain": "www.forbes.com",
"tld": "com",
"page": "https://www.forbes.com/sites/jaysondemers/2015/02/19/the-importance-of-social-validation-in-online-marketing/",
"ip": "151.101.1.55",
"first_visited": "2019-01-23 03:14:43 +00:00",
"prev_visited": "2023-06-16 20:18:54 +00:00",
"fetch_time": "2023-08-24 17:46:19 +00:00",
"status_code": 200,
"location": null,
"size": 454271,
"encoded_size": 82297,
"content_encoding": "gzip",
"media_type": "text/html",
"server": "rhino-core-shield",
"meta": {
"title": "The Importance Of Social Validation In Online Marketing",
"canonical": null,
"internal_links_count": 13,
"external_links_count": 6,
"images_count": 1,
"words_count": 1239,
"page_spam_score": 0,
"social_media_tags": {
"og:title": "The Importance Of Social Validation In Online Marketing",
"og:site_name": "Forbes",
"og:type": "article",
"og:url": "https://www.forbes.com/sites/jaysondemers/2015/02/19/the-importance-of-social-validation-in-online-marketing/",
"image": "https://imageio.forbes.com/blogs-images/jaysondemers/files/2014/10/ranch_penguins4.jpg?format=jpg&width=1200",
"og:description": "Online marketing comprises many factors, strategies, and tactics, but all of them share a common end goal: to get more people to buy your products or services. To get there, you have to step past the competition, increase the traffic to your site, and build better relationships with your customers. [...]",
"og:updated_time": "2015-07-01T13:13:34.591-04:00",
"fb:app_id": "123694841080850",
"twitter:card": "summary_large_image",
"twitter:site": "@forbes",
"twitter:creator": "@jaysondemers",
"twitter:title": "The Importance Of Social Validation In Online Marketing",
"twitter:description": "Online marketing comprises many factors, strategies, and tactics, but all of them share a common end goal: to get more people to buy your products or services. To get there, you have to step past the competition, increase the traffic to your site, and build better relationships with your customers. [...]",
"twitter:image": "https://imageio.forbes.com/blogs-images/jaysondemers/files/2014/10/ranch_penguins4.jpg?format=jpg&width=1200"
},
"h1": [
"The Importance Of Social Validation In Online Marketing"
],
"h2": null,
"h3": [
"More From Forbes"
],
"images_alt": [
"Jayson DeMers"
],
"powered_by": null,
"language": "en",
"charset": "utf-8",
"platform_type": [
"news"
],
"technologies": null
},
"page_summary": {
"first_seen": "2019-01-23 03:14:43 +00:00",
"lost_date": null,
"rank": 429,
"backlinks": 128,
"backlinks_spam_score": 10,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 11,
"referring_domains_nofollow": 3,
"referring_main_domains": 11,
"referring_main_domains_nofollow": 3,
"referring_ips": 11,
"referring_subnets": 11,
"referring_pages": 128,
"referring_links_tld": {
"com": 112,
"com.ua": 16
},
"referring_links_types": {
"anchor": 128
},
"referring_links_attributes": {
"noopener": 64,
"nofollow": 32,
"noreferrer": 16
},
"referring_links_platform_types": {
"cms": 96,
"blogs": 80,
"organization": 48,
"message-boards": 16,
"news": 16,
"unknown": 16
},
"referring_links_semantic_locations": {
"article": 80,
"section": 32,
"": 16
},
"referring_links_countries": {
"": 80,
"MM": 16,
"UA": 16,
"US": 16
},
"referring_pages_nofollow": 3
}
},
{
"type": "backlinks_domain_page",
"main_domain": "forbes.com",
"domain": "www.forbes.com",
"tld": "com",
"page": "http://www.forbes.com/sites/ryanmac/2015/10/14/buildzoom-raises-10-6-million-from-formation-8-y-combinator-to-focus-on-high-end-home-improvements/",
"ip": "151.101.1.55",
"first_visited": "2019-03-23 10:50:51 +00:00",
"prev_visited": "2023-06-30 14:57:07 +00:00",
"fetch_time": "2023-08-29 20:53:48 +00:00",
"status_code": 301,
"location": "https://www.forbes.com/sites/ryanmac/2015/10/14/buildzoom-raises-10-6-million-from-formation-8-y-combinator-to-focus-on-high-end-home-improvements/",
"size": 0,
"encoded_size": 0,
"content_encoding": null,
"media_type": null,
"server": "Varnish",
"meta": {
"title": null,
"canonical": null,
"internal_links_count": 0,
"external_links_count": 0,
"images_count": 0,
"words_count": 0,
"page_spam_score": 0,
"social_media_tags": null,
"h1": null,
"h2": null,
"h3": null,
"images_alt": null,
"powered_by": null,
"language": null,
"charset": null,
"platform_type": null,
"technologies": null
},
"page_summary": {
"first_seen": "2019-03-23 10:50:51 +00:00",
"lost_date": null,
"rank": 407,
"backlinks": 910240,
"backlinks_spam_score": 0,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 3,
"referring_domains_nofollow": 0,
"referring_main_domains": 3,
"referring_main_domains_nofollow": 0,
"referring_ips": 4,
"referring_subnets": 4,
"referring_pages": 910240,
"referring_links_tld": {
"com": 910240
},
"referring_links_types": {
"anchor": 910240
},
"referring_links_attributes": null,
"referring_links_platform_types": {
"unknown": 522896,
"organization": 360400,
"message-boards": 26944
},
"referring_links_semantic_locations": {
"": 910240
},
"referring_links_countries": {
"US": 910128,
"": 112
},
"referring_pages_nofollow": 8
}
},
{
"type": "backlinks_domain_page",
"main_domain": "forbes.com",
"domain": "www.forbes.com",
"tld": "com",
"page": "https://www.forbes.com/sites/emmawoollacott/2021/12/29/cryptomining-malware-found-in-spider-man-no-way-home-torrents/amp/",
"ip": "151.101.1.55",
"first_visited": "2022-01-17 17:34:00 +00:00",
"prev_visited": "2023-02-13 20:18:46 +00:00",
"fetch_time": "2023-05-01 10:29:05 +00:00",
"status_code": 200,
"location": null,
"size": 236313,
"encoded_size": 39458,
"content_encoding": "gzip",
"media_type": "text/html",
"server": "rhino-core-shield",
"meta": {
"title": "Cryptomining Malware Found In Spider-Man: No Way Home Torrents",
"canonical": "https://www.forbes.com/sites/emmawoollacott/2021/12/29/cryptomining-malware-found-in-spider-man-no-way-home-torrents/",
"internal_links_count": 0,
"external_links_count": 0,
"images_count": 0,
"words_count": 0,
"page_spam_score": 0,
"social_media_tags": {
"og:title": "Cryptomining Malware Found In Spider-Man: No Way Home Torrents",
"og:site_name": "Forbes",
"og:type": "article",
"og:url": "https://www.forbes.com/sites/emmawoollacott/2021/12/29/cryptomining-malware-found-in-spider-man-no-way-home-torrents/",
"image": "https://imageio.forbes.com/specials-images/imageserve/61cc55975f4b84c12b90a845/0x0.jpg?format=jpg&width=1200",
"og:description": "Security firm ReasonLabs is warning movie fans that pirated copies of Spider-Man: No Way Home contain cryptomining malware.",
"og:updated_time": "2022-04-21T08:14:07.948-04:00",
"fb:app_id": "123694841080850",
"twitter:card": "summary_large_image",
"twitter:site": "@forbes",
"twitter:creator": "@EmmaWoollacott",
"twitter:title": "Cryptomining Malware Found In Spider-Man: No Way Home Torrents",
"twitter:description": "Security firm ReasonLabs is warning movie fans that pirated copies of Spider-Man: No Way Home contain cryptomining malware.",
"twitter:image": "https://imageio.forbes.com/specials-images/imageserve/61cc55975f4b84c12b90a845/0x0.jpg?format=jpg&width=1200"
},
"h1": null,
"h2": null,
"h3": null,
"images_alt": null,
"powered_by": null,
"language": "en",
"charset": "utf-8",
"platform_type": null,
"technologies": null
},
"page_summary": {
"first_seen": "2022-01-17 17:34:00 +00:00",
"lost_date": null,
"rank": 406,
"backlinks": 16,
"backlinks_spam_score": 0,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 1,
"referring_domains_nofollow": 0,
"referring_main_domains": 1,
"referring_main_domains_nofollow": 0,
"referring_ips": 1,
"referring_subnets": 1,
"referring_pages": 16,
"referring_links_tld": {
"com": 16
},
"referring_links_types": {
"anchor": 16
},
"referring_links_attributes": null,
"referring_links_platform_types": {
"unknown": 16
},
"referring_links_semantic_locations": {
"main": 16
},
"referring_links_countries": {
"": 16
},
"referring_pages_nofollow": 1
}
},
{
"type": "backlinks_domain_page",
"main_domain": "forbes.com",
"domain": "www.forbes.com",
"tld": "com",
"page": "https://www.forbes.com/sites/gregautry/2020/03/25/building-the-social-news-network-to-end-fake-news/?sh=248b16e557ae",
"ip": "151.101.1.55",
"first_visited": "2021-07-19 15:21:23 +00:00",
"prev_visited": "2023-05-01 08:44:16 +00:00",
"fetch_time": "2023-06-30 10:49:58 +00:00",
"status_code": 200,
"location": null,
"size": 538659,
"encoded_size": 89668,
"content_encoding": "gzip",
"media_type": "text/html",
"server": "rhino-core-shield",
"meta": {
"title": "Building The Social News Network To End Fake News",
"canonical": "https://www.forbes.com/sites/gregautry/2020/03/25/building-the-social-news-network-to-end-fake-news/",
"internal_links_count": 0,
"external_links_count": 0,
"images_count": 0,
"words_count": 0,
"page_spam_score": 0,
"social_media_tags": {
"og:title": "Building The Social News Network To End Fake News",
"og:site_name": "Forbes",
"og:type": "article",
"og:url": "https://www.forbes.com/sites/gregautry/2020/03/25/building-the-social-news-network-to-end-fake-news/",
"image": "https://imageio.forbes.com/specials-images/imageserve/5e7acc72d8e1ae0007b7702e/0x0.jpg?format=jpg&width=1200",
"og:description": "Overlooked, created by young entrepreneur George Sehremelis, brings curated news with bias detection to your web browser and phone.",
"og:updated_time": "2020-03-25T00:47:57.043-04:00",
"fb:app_id": "123694841080850",
"twitter:card": "summary_large_image",
"twitter:site": "@forbes",
"twitter:creator": "@@GregWAutry",
"twitter:title": "Building The Social News Network To End Fake News",
"twitter:description": "Overlooked, created by young entrepreneur George Sehremelis, brings curated news with bias detection to your web browser and phone.",
"twitter:image": "https://imageio.forbes.com/specials-images/imageserve/5e7acc72d8e1ae0007b7702e/0x0.jpg?format=jpg&width=1200"
},
"h1": null,
"h2": null,
"h3": null,
"images_alt": null,
"powered_by": null,
"language": "en",
"charset": "utf-8",
"platform_type": null,
"technologies": null
},
"page_summary": {
"first_seen": "2021-07-19 15:21:23 +00:00",
"lost_date": null,
"rank": 390,
"backlinks": 16,
"backlinks_spam_score": 25,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 1,
"referring_domains_nofollow": 0,
"referring_main_domains": 1,
"referring_main_domains_nofollow": 0,
"referring_ips": 1,
"referring_subnets": 1,
"referring_pages": 16,
"referring_links_tld": {
"com": 16
},
"referring_links_types": {
"image": 16
},
"referring_links_attributes": {
"noopener": 16,
"noreferrer": 16
},
"referring_links_platform_types": {
"unknown": 16
},
"referring_links_semantic_locations": {
"": 16
},
"referring_links_countries": {
"": 16
},
"referring_pages_nofollow": 6
}
},
{
"type": "backlinks_domain_page",
"main_domain": "forbes.com",
"domain": "www.forbes.com",
"tld": "com",
"page": "http://www.forbes.com/sites/lorikozlowski/2012/07/13/a-startup-for-smarter-and-more-voters/",
"ip": "151.101.1.55",
"first_visited": "2021-07-19 15:32:32 +00:00",
"prev_visited": "2023-06-15 13:43:10 +00:00",
"fetch_time": "2023-08-23 17:53:32 +00:00",
"status_code": 301,
"location": "https://www.forbes.com/sites/lorikozlowski/2012/07/13/a-startup-for-smarter-and-more-voters/",
"size": 0,
"encoded_size": 0,
"content_encoding": null,
"media_type": null,
"server": "Varnish",
"meta": {
"title": null,
"canonical": null,
"internal_links_count": 0,
"external_links_count": 0,
"images_count": 0,
"words_count": 0,
"page_spam_score": 0,
"social_media_tags": null,
"h1": null,
"h2": null,
"h3": null,
"images_alt": null,
"powered_by": null,
"language": null,
"charset": null,
"platform_type": null,
"technologies": null
},
"page_summary": {
"first_seen": "2021-07-19 15:32:32 +00:00",
"lost_date": null,
"rank": 383,
"backlinks": 1392,
"backlinks_spam_score": 0,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 62,
"referring_domains_nofollow": 1,
"referring_main_domains": 3,
"referring_main_domains_nofollow": 1,
"referring_ips": 8,
"referring_subnets": 8,
"referring_pages": 1392,
"referring_links_tld": {
"com": 1392
},
"referring_links_types": {
"anchor": 1392
},
"referring_links_attributes": {
"nofollow": 16
},
"referring_links_platform_types": {
"unknown": 1392
},
"referring_links_semantic_locations": {
"": 1392
},
"referring_links_countries": {
"": 1296,
"GB": 48,
"US": 48
},
"referring_pages_nofollow": 16
}
}
]
}
]
}
]
}