How do I access backlink summary data for my pages?
in
Our new Domain Pages Summary 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.
1 Call the endpoint.
POST https://api.dataforseo.com/v3/backlinks/domain_pages_summary/live
2 Specify your domain, subdomain, or a single page in the target field. Note: domains and subdomains should be specified without https:// and www., whereas pages should be specified with absolute url, including https:// or http://.
3 Set backlinks_status_type. This parameter indicates which backlinks will be returned and used for aggregated metrics for your target. Can take the following values:
all— all backlinks will be returned and counted;live— backlinks found during the last check will be returned and counted;;lost— lost backlinks will be returned and counted
Your POST request should be structured as in the following example:
[
{
"target": "forbes.com",
"limit": 4,
"order_by": ["backlinks,desc"]
}
]
Example of the API response:
{
"version": "0.1.20220428",
"status_code": 20000,
"status_message": "Ok.",
"time": "3.4326 sec.",
"cost": 0.02012,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "05101918-1535-0445-0000-f03eab9c3c6e",
"status_code": 20000,
"status_message": "Ok.",
"time": "3.3785 sec.",
"cost": 0.02012,
"result_count": 1,
"path": [
"v3",
"backlinks",
"domain_pages_summary",
"live"
],
"data": {
"api": "backlinks",
"function": "domain_pages_summary",
"target": "forbes.com",
"limit": 4,
"order_by": [
"backlinks,desc"
]
},
"result": [
{
"target": "forbes.com",
"total_count": 3010233,
"items_count": 4,
"items": [
{
"type": "backlinks_page_summary",
"url": "https://www.forbes.com/privacy/english/",
"rank": 299,
"backlinks": 3960665,
"first_seen": "2019-11-14 18:24:39 +00:00",
"lost_date": null,
"backlinks_spam_score": 39,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 547,
"referring_main_domains": 529,
"referring_ips": 445,
"referring_subnets": 305,
"referring_pages": 3018955,
"referring_links_tld": {
"net": 2474679,
"com": 535203,
"pl": 7998,
"": 287,
"org.ua": 200,
"org": 135,
"com.ua": 99,
"de": 73,
"org.ru": 66,
"info": 53
},
"referring_links_types": {
"anchor": 3018954,
"canonical": 1
},
"referring_links_attributes": {
"nofollow": 878,
"noopener": 623,
"noreferrer": 158,
"external": 29,
"ugc": 1
},
"referring_links_platform_types": {
"unknown": 3018153,
"cms": 529,
"blogs": 504,
"ecommerce": 1
},
"referring_links_semantic_locations": {
"details": 2526850,
"": 490957,
"section": 745,
"article": 340,
"footer": 33,
"main": 29,
"header": 1
}
},
{
"type": "backlinks_page_summary",
"url": "https://www.forbes.com/sites/brianrashid/2017/03/24/studypools-microtutoring-is-flipping-education-upside-down-heres-how-the-young-visionaries-did-it/",
"rank": 593,
"backlinks": 2548973,
"first_seen": "2019-01-15 23:19:44 +00:00",
"lost_date": null,
"backlinks_spam_score": 0,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 73,
"referring_main_domains": 72,
"referring_ips": 73,
"referring_subnets": 60,
"referring_pages": 2517265,
"referring_links_tld": {
"com": 2517173,
"org": 57,
"net": 14,
"us": 10,
"info": 7,
"edu": 2,
"in": 1,
"me": 1
},
"referring_links_types": {
"anchor": 2517265
},
"referring_links_attributes": {
"noopener": 156,
"noreferrer": 37,
"nofollow": 30
},
"referring_links_platform_types": {
"unknown": 2517099,
"blogs": 164,
"cms": 164,
"ecommerce": 7,
"wikis": 2
},
"referring_links_semantic_locations": {
"": 2485392,
"section": 31761,
"article": 95,
"main": 9,
"figure": 3,
"aside": 2,
"figcaption": 2,
"header": 1
}
},
{
"type": "backlinks_page_summary",
"url": "http://www.forbes.com/",
"rank": 480,
"backlinks": 2368206,
"first_seen": "2019-01-15 22:55:54 +00:00",
"lost_date": null,
"backlinks_spam_score": 41,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 28899,
"referring_main_domains": 22857,
"referring_ips": 19226,
"referring_subnets": 13682,
"referring_pages": 1808822,
"referring_links_tld": {
"com": 1234568,
"org": 218489,
"edu.pk": 125642,
"al": 104531,
"ac.uk": 47107,
"ba": 18313,
"net": 11056,
"fr": 8110,
"es": 3913,
"co": 3735
},
"referring_links_types": {
"anchor": 1808666,
"redirect": 151,
"canonical": 5
},
"referring_links_attributes": {
"noopener": 153827,
"nofollow": 20836,
"noreferrer": 11601,
"external": 8843,
"ugc": 1294,
"author": 129,
"alternate": 15,
"tag": 12,
"bookmark": 9,
"sponsored": 5
},
"referring_links_platform_types": {
"unknown": 1676482,
"cms": 126773,
"blogs": 126292,
"ecommerce": 1406,
"message-boards": 627,
"wikis": 435
},
"referring_links_semantic_locations": {
"": 1359627,
"article": 215243,
"aside": 134460,
"footer": 34825,
"section": 34386,
"nav": 23590,
"main": 3191,
"figure": 1920,
"header": 1379,
"figcaption": 180
}
},
{
"type": "backlinks_page_summary",
"url": "https://www.forbes.com/",
"rank": 547,
"backlinks": 1441189,
"first_seen": "2019-01-15 23:04:28 +00:00",
"lost_date": null,
"backlinks_spam_score": 12,
"broken_backlinks": 0,
"broken_pages": 0,
"referring_domains": 29059,
"referring_main_domains": 25316,
"referring_ips": 24162,
"referring_subnets": 11964,
"referring_pages": 1179604,
"referring_links_tld": {
"com": 833881,
"ir": 153450,
"net": 106437,
"ba": 35433,
"org": 8993,
"co": 6197,
"ru": 4745,
"at": 2817,
"info": 1701,
"co.uk": 1503
},
"referring_links_types": {
"anchor": 1179531,
"redirect": 60,
"canonical": 13
},
"referring_links_attributes": {
"noopener": 603844,
"nofollow": 37551,
"noreferrer": 35803,
"external": 1682,
"ugc": 434,
"author": 100,
"sponsored": 51,
"bookmark": 8,
"alternate": 7,
"help": 2
},
"referring_links_platform_types": {
"cms": 857538,
"blogs": 797430,
"unknown": 313790,
"ecommerce": 4169,
"wikis": 796,
"message-boards": 259
},
"referring_links_semantic_locations": {
"": 430595,
"aside": 405978,
"section": 251320,
"article": 65441,
"footer": 11707,
"main": 7268,
"header": 4233,
"nav": 1732,
"figcaption": 724,
"figure": 588
}
}
]
}
]
}
]
}