Help Center

How do I access backlink summary data for my pages?

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
                            }
                        }
                    ]
                }
            ]
        }
    ]
}