{"id":18752,"date":"2024-04-24T13:26:39","date_gmt":"2024-04-24T13:26:39","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=18752"},"modified":"2025-04-11T12:04:54","modified_gmt":"2025-04-11T12:04:54","slug":"backlinks-bulk_pages_summary-live","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/backlinks-bulk_pages_summary-live\/","title":{"rendered":"backlinks\/bulk_pages_summary\/live"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h2 id=\"setting-serp-tasks\">Bulk Pages Summary<\/h2>\n<p>&thinsp;<br \/>\nThis 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.<\/p>\n<p>[\/vc_column_text]    <div class=\"endpoint\">\n        <img decoding=\"async\" class=\"endpoint__icon\" src=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/checked-circle.svg\" alt=\"checked\">\n\n                    POST            <button class=\"btn-reset button-link copy-button\" data-href=\"https:\/\/api.dataforseo.com\/v3\/backlinks\/bulk_pages_summary\/live\">\n                https:\/\/api.dataforseo.com\/v3\/backlinks\/bulk_pages_summary\/live                <svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\">\n                    <use href=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/sprite.svg#layers\"><\/use>\n                <\/svg>\n            <\/button>\n            <\/div>\n    \t<article class=\"info-card info-card--yellow\">\n\t\t<header class=\"info-card__header\">\n\t\t\t<div class=\"info-card__icon\">\n\t\t\t\t<svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\">\n\t\t\t\t\t<use href=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/sprite.svg#label\"><\/use>\n\t\t\t\t<\/svg>\n\t\t\t<\/div>\n\t\t\t<div class=\"info-card__title\">Pricing<\/div>\n\t\t<\/header>\n\t\t<div class=\"info-card__content\">\n\t\t\t<p> Your account will be charged for each request.<br \/>\nThe cost can be calculated on the <a title=\"Pricing\" href=\"https:\/\/dataforseo.com\/pricing\/backlinks\/backlinks\" target=\"_blank\" rel=\"noopener noreferrer\">Pricing<\/a> page.<\/p>\n\t\t<\/div>\n\t<\/article>\n\t[vc_column_text]All POST data should be sent in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON\">JSON<\/a> 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.<\/p>\n<p><strong>Description of the fields for setting a task:<\/strong><\/p>\n<table style=\"width: 100%; height: 1765px;\">\n<thead>\n<tr style=\"height: 24px;\">\n<th style=\"width: 12.4003%; height: 24px;\">Field name<\/th>\n<th style=\"width: 3.91588%; height: 24px;\">Type<\/th>\n<th style=\"width: 82.9587%; height: 24px;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 144px;\">\n<td style=\"width: 12.4003%; height: 144px;\"><code>targets<\/code><\/td>\n<td style=\"width: 3.91588%; height: 144px;\">array<\/td>\n<td style=\"width: 82.9587%; height: 144px;\"><em>domains, subdomains or webpages to get summary data for<\/em><br \/>\n<strong>required field<\/strong><br \/>\na domain or a subdomain should be specified without <code>https:\/\/<\/code> and <code>www.<\/code><br \/>\na page should be specified with absolute URL (including <code>http:\/\/<\/code> or <code>https:\/\/<\/code>)<br \/>\nyou can specify up to 1000 pages, domains, or subdomains in each request.<br \/>\n<strong>note that the URLs you set in a single request cannot belong to more than 100 different domains<\/strong>.<\/td>\n<\/tr>\n<tr style=\"height: 96px;\">\n<td style=\"width: 12.4003%; height: 77px;\"><code>include_subdomains<\/code><\/td>\n<td style=\"width: 3.91588%; height: 77px;\">boolean<\/td>\n<td style=\"width: 82.9587%; height: 77px;\"><em>indicates if the subdomains of the <code>target<\/code> will be included in the search<\/em><br \/>\noptional field<br \/>\nif set to <code>false<\/code>, the subdomains will be ignored<br \/>\ndefault value: <code>true<\/code><\/td>\n<\/tr>\n<tr style=\"height: 96px;\">\n<td style=\"width: 12.4003%; height: 96px;\"><code>rank_scale<\/code><\/td>\n<td style=\"width: 3.91588%; height: 96px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 96px;\"><em>defines the scale used for calculating and displaying the <code>rank<\/code>, <code>domain_from_rank<\/code>, and <code>page_from_rank<\/code> values<\/em><br \/>\noptional field<\/p>\n<p>you can use this parameter to choose whether rank values are presented on a 0\u2013100 or 0\u20131000 scale<\/p>\n<p>possible values:<br \/>\n<code>one_hundred<\/code> \u2014 rank values are displayed on a 0\u2013100 scale<br \/>\n<code>one_thousand<\/code> \u2014 rank values are displayed on a 0\u20131000 scale<\/p>\n<p>default value: <code>one_thousand<\/code><\/p>\n<p>learn more about how this parameter works and how ranking metrics are calculated in <a href=\"https:\/\/dataforseo.com\/help-center\/what_is_rank_in_backlinks_api#rank_scale\">this Help Center article<\/a>\n<\/td>\n<\/tr>\n<tr style=\"height: 96px;\">\n<td style=\"width: 12.4003%; height: 96px;\"><code>tag<\/code><\/td>\n<td style=\"width: 3.9884%; height: 96px;\">string<\/td>\n<td style=\"width: 82.8862%; height: 96px;\"><em>user-defined task identifier<\/em><br \/>\noptional field<br \/>\n<em>the character limit is 255<\/em><br \/>\nyou can use this parameter to identify the task and match it with the result<br \/>\nyou will find the specified <code>tag<\/code> value in the <code>data<\/code> object of the response<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\u200c\u200c\u200c\u200c\u200c\u200c<br \/>\nAs a response of the API server, you will receive <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON\">JSON<\/a>-encoded data containing a <code>tasks<\/code> array with the information specific to the set tasks.<\/p>\n<p><strong>Description of the fields in the results array:<\/strong><\/p>\n<table style=\"width: 77.3646%; height: 552px;\">\n<thead>\n<tr style=\"height: 24px;\">\n<th style=\"width: 38.423%; height: 24px;\">Field name<\/th>\n<th style=\"width: 1.25156%; height: 24px;\">Type<\/th>\n<th style=\"width: 61.7021%; height: 24px;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 48px;\">\n<td style=\"width: 24.3517%; height: 48px;\"><code>version<\/code><\/td>\n<td style=\"width: 6.19209%; height: 48px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 48px;\"><em>the current version of the API<\/em><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 38.423%; height: 48px;\"><code>status_code<\/code><\/td>\n<td style=\"width: 1.75219%; height: 48px;\">integer<\/td>\n<td style=\"width: 61.2015%; height: 48px;\"><i>general status code<\/i><br \/>\nyou can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><br \/>\n<strong>Note:<\/strong> we strongly recommend designing a necessary system for handling related exceptional or error conditions<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>status_message<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>general informational message<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>time<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>execution time, seconds<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>cost<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>total <i>tasks<\/i> cost, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>tasks_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>tasks_error<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array returned with an error<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><strong><code>tasks<\/code><\/strong><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>array of tasks<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>id<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>task identifier<\/em><br \/>\n<strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\">UUID<\/a> format<\/strong><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 24.3517%; height: 48px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>status_code<\/code><\/td>\n<td style=\"width: 6.19209%; height: 48px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 48px;\"><em>status code of the task<\/em><br \/>\ngenerated by DataForSEO; can be within the following range: 10000-60000<br \/>\nyou can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>status_message<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>informational message of the task<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>time<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>execution time, seconds<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>cost<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">float<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>cost of the task, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>result_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of elements in the <code>result<\/code> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>path<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>URL path<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>data<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>contains the same parameters that you specified in the POST request<br \/>\n<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 <strong>\u00a0 \u00a0 <code>result<\/code><\/strong><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>array of results<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>total_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>total number of relevant items in the database<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>items_count<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of items in the results array<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <strong><code>items<\/code><\/strong><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">array<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>items array<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>type<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em> type of element\u00a0=\u00a0<strong>&#8216;backlinks_page_summary&#8217;<\/strong><\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>url<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>page URL<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>rank<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>page rank<\/em><br \/>\nrank of the page on the <code>target<\/code> website<br \/>\n<code>rank<\/code> is calculated based on the method for node ranking in a linked database &#8211; a principle used in the original Google PageRank algorithm<br \/>\nlearn more about the metric and how it is calculated in <a href=\"https:\/\/dataforseo.com\/help-center\/what_is_rank_in_backlinks_api\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>main_domain_rank<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>rank of the main domain<\/em><br \/>\nrank of the main domain is calculated based on the method for node ranking in a linked database &#8211; a principle used in the original Google PageRank algorithm<br \/>\nlearn more about the metric and how it is calculated in <a href=\"https:\/\/dataforseo.com\/help-center\/what_is_rank_in_backlinks_api\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>backlinks<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of backlinks<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>first_seen<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>date and time when our crawler found a backlink to this page for the first time<\/em><br \/>\nin the UTC format: &#8220;yyyy-mm-dd hh-mm-ss +00:00&#8221;<br \/>\nexample:<br \/>\n<code>2019-11-15 12:57:46 +00:00<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>lost_date<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>date and time when the last backlink to this page was lost<\/em><br \/>\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<br \/>\nin the UTC format: &#8220;yyyy-mm-dd hh-mm-ss +00:00&#8221;<br \/>\nexample:<br \/>\n<code>2017-01-24 13:20:59 +00:00<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>backlinks_spam_score<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>average spam score of the backlinks pointing to the page<\/em><br \/>\nlearn more about how the metric is calculated on <a href=\"https:\/\/dataforseo.com\/help-center\/what-is-spam-score-and-how-is-it-calculated\" rel=\"noopener noreferrer\" target=\"_blank\">this help center page<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>broken_backlinks<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of broken backlinks<\/em><br \/>\nnumber of broken backlinks pointing to the page<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>broken_pages<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of broken pages<\/em><br \/>\nnumber of pages that respond with 4xx or 5xx status codes where backlinks are pointing to<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_domains<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>indicates the number domains referring to the page<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_domains_nofollow<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of domains pointing at least one nofollow link to the <code>target<\/code><\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_main_domains<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>indicates the number of referring main domains<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_main_domains_nofollow<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of main domains pointing at least one nofollow link to the <code>target<\/code><\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_ips<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of referring IP addresses<\/em><br \/>\nnumber of IP addresses pointing to this page\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_subnets<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of referring subnetworks<\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_pages<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>indicates the number of pages pointing to the relevant <code>url<\/code><\/em>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_pages_nofollow<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">integer<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>number of referring pages pointing at least one nofollow link to the <code>target<\/code><\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_links_tld<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>top-level domains of the referring links<\/em><br \/>\ncontains top level domains and referring link count per each\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_links_types<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>types of referring links<\/em><br \/>\nindicates the types of the referring links and link count per each type<br \/>\npossible values:<br \/>\n<code>anchor<\/code>, <code>image<\/code>, <code>link<\/code>, <code>meta<\/code>, <code>canonical<\/code>, <code>alternate<\/code>, <code>redirect<\/code>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_links_attributes<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>link attributes of the referring links<\/em><br \/>\nindicates link attributes of the referring links and link count per each attribute\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_links_platform_types<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>types of referring platforms<\/em><br \/>\nindicates referring platform types and and link count per each platform<\/p>\n<p>possible values: <code>cms<\/code>, <code>blogs<\/code>, <code>ecommerce<\/code>, <code>message-boards<\/code>, <code>wikis<\/code>, <code>news<\/code>, <code>organization<\/code>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_links_semantic_locations<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>semantic locations of the referring links<\/em><br \/>\nindicates semantic elements in HTML where the referring links are located and link count per each semantic location<\/p>\n<p>you can get the full list of semantic elements <a href=\"https:\/\/www.w3schools.com\/html\/html5_semantic_elements.asp\" target=\"_blank\" rel=\"noopener noreferrer\">here<\/a><br \/>\nexamples:<br \/>\n<code>article<\/code>, <code>section<\/code>, <code>footer<\/code>\n<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\">\u00a0\u00a0 \u00a0  \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>referring_links_countries<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">object<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>ISO country codes of the referring links<\/em><br \/>\nindicates ISO country codes of the domains where the referring links are located and the link count per each country\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\u200c\u200c[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<blockquote><p>Instead of \u2018login\u2019 and \u2018password\u2019 use your credentials from https:\/\/app.dataforseo.com\/api-access<\/p><\/blockquote><div id=\"curl\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-bash hljs\"># Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access \r\nlogin=&quot;login&quot; \r\npassword=&quot;password&quot; \r\ncred=&quot;$(printf ${login}:${password} | base64)&quot; \r\ncurl --location --request POST &quot;https:\/\/api.dataforseo.com\/v3\/backlinks\/bulk_pages_summary\/live&quot; \r\n--header &quot;Authorization: Basic ${cred}&quot;  \r\n--header &quot;Content-Type: application\/json&quot; \r\n--data-raw &#039;[\r\n  {\r\n    &quot;targets&quot;: [\r\n      &quot;https:\/\/dataforseo.com\/solutions&quot;,\r\n      &quot;https:\/\/dataforseo.com\/about-us&quot;\r\n    ]\r\n  }\r\n]&#039;<\/code><\/pre><\/div><\/div><div id=\"php\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-php hljs\">&lt;?php\r\n\/\/ You can download this file from here https:\/\/cdn.dataforseo.com\/v3\/examples\/php\/php_RestClient.zip\r\nrequire(&#039;RestClient.php&#039;);\r\n$api_url = &#039;https:\/\/api.dataforseo.com\/&#039;;\r\n\/\/ Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access\r\n$client = new RestClient($api_url, null, &#039;login&#039;, &#039;password&#039;);\r\n\r\n$post_array = array();\r\n\/\/ simple way to set a task\r\n$post_array[] = array(\r\n\t&quot;targets&quot; =&gt; [\r\n\t\t&quot;https:\/\/dataforseo.com\/&quot;,\r\n\t\t&quot;https:\/\/dataforseo.com\/about-us&quot;\r\n\t]\r\n);\r\ntry {\r\n\t\/\/ POST \/v3\/backlinks\/bulk_pages_summary\/live\r\n\t$result = $client-&gt;post(&#039;\/v3\/backlinks\/bulk_pages_summary\/live&#039;, $post_array);\r\n\tprint_r($result);\r\n\t\/\/ do something with post result\r\n} catch (RestClientException $e) {\r\n\techo &quot;n&quot;;\r\n\tprint &quot;HTTP code: {$e-&gt;getHttpCode()}n&quot;;\r\n\tprint &quot;Error code: {$e-&gt;getCode()}n&quot;;\r\n\tprint &quot;Message: {$e-&gt;getMessage()}n&quot;;\r\n\tprint  $e-&gt;getTraceAsString();\r\n\techo &quot;n&quot;;\r\n}\r\n$client = null;\r\n?&gt;<\/code><\/pre><\/div><\/div><div id=\"javascript\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-javascript hljs\">var request = require(&#039;request&#039;);\r\nvar options = {\r\n  &#039;method&#039;: &#039;POST&#039;,\r\n  &#039;url&#039;: &#039;https:\/\/api.dataforseo.com\/v3\/backlinks\/bulk_pages_summary\/live&#039;,\r\n  &#039;headers&#039;: {\r\n    &#039;Content-Type&#039;: &#039;application\/json&#039;,\r\n    &#039;Authorization&#039;: &#039;Basic c3VwcG9ydEBkYXRhZm9yc2VvLmNvbTpTUnJYVHp2UGtFSjgzdXlz&#039;\r\n  },\r\n  body: JSON.stringify([\r\n    {\r\n      &quot;targets&quot;: [\r\n        &quot;https:\/\/dataforseo.com\/solutions&quot;,\r\n        &quot;https:\/\/dataforseo.com\/about-us&quot;\r\n      ]\r\n    }\r\n  ])\r\n\r\n};\r\nrequest(options, function (error, response) {\r\n  if (error) throw new Error(error);\r\n  console.log(response.body);\r\n});<\/code><\/pre><\/div><\/div><div id=\"python\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-python hljs\">from client import RestClient\r\n# You can download this file from here https:\/\/cdn.dataforseo.com\/v3\/examples\/python\/python_Client.zip\r\nclient = RestClient(&quot;login&quot;, &quot;password&quot;)\r\npost_data = dict()\r\n# simple way to set a task\r\npost_data[len(post_data)] = dict(\r\n    targets=[\r\n        &quot;https:\/\/dataforseo.com\/&quot;,\r\n        &quot;https:\/\/dataforseo.com\/about-us&quot;\r\n    ]\r\n)\r\n# POST \/v3\/backlinks\/bulk_pages_summary\/live\r\nresponse = client.post(&quot;\/v3\/backlinks\/bulk_pages_summary\/live&quot;, post_data)\r\n# you can find the full list of the response codes here https:\/\/docs.dataforseo.com\/v3\/appendix\/errors\r\nif response[&quot;status_code&quot;] == 20000:\r\n    print(response)\r\n    # do something with result\r\nelse:\r\n    print(&quot;error. Code: %d Message: %s&quot; % (response[&quot;status_code&quot;], response[&quot;status_message&quot;]))<\/code><\/pre><\/div><\/div><div id=\"csharp\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-csharp hljs\">using Newtonsoft.Json;\r\nusing System;\r\nusing System.Collections.Generic;\r\nusing System.Net.Http;\r\nusing System.Net.Http.Headers;\r\nusing System.Text;\r\nusing System.Threading.Tasks;\r\n\r\nnamespace DataForSeoDemos\r\n{\r\n    public static partial class Demos\r\n    {\r\n        public static async Task backlinks_bulk_pages_summary_live()\r\n        {\r\n            var httpClient = new HttpClient\r\n            {\r\n                BaseAddress = new Uri(&quot;https:\/\/api.dataforseo.com\/&quot;),\r\n                \/\/ Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access\r\n                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue(&quot;Basic&quot;, Convert.ToBase64String(Encoding.ASCII.GetBytes(&quot;login:password&quot;))) }                \r\n            };\r\n            var postData = new List&lt;object&gt;();\r\n            postData.Add(new\r\n            {\r\n                targets = new[]\r\n                {\r\n                    &quot;https:\/\/dataforseo.com\/&quot;,\r\n                    &quot;https:\/\/dataforseo.com\/about-us&quot;\r\n                }\r\n            });\r\n            \/\/ POST \/v3\/backlinks\/bulk_pages_summary\/live\r\n            \/\/ the full list of possible parameters is available in documentation\r\n            var taskPostResponse = await httpClient.PostAsync(&quot;\/v3\/backlinks\/bulk_pages_summary\/live&quot;, new StringContent(JsonConvert.SerializeObject(postData)));\r\n            var result = JsonConvert.DeserializeObject&lt;dynamic&gt;(await taskPostResponse.Content.ReadAsStringAsync());\r\n            \/\/ you can find the full list of the response codes here https:\/\/docs.dataforseo.com\/v3\/appendix\/errors\r\n            if (result.status_code == 20000)\r\n            {\r\n                \/\/ do something with result\r\n                Console.WriteLine(result);\r\n            }\r\n            else\r\n                Console.WriteLine($&quot;error. Code: {result.status_code} Message: {result.status_message}&quot;);\r\n        }\r\n    }\r\n}<\/code><\/pre><\/div><\/div><blockquote><p>The above command returns JSON structured like this:<\/p><\/blockquote><div class=\"example example--json\"><div class=\"example__content\"><div class=\"example__code example__code-json\"><pre><code class=\"language-json hljs\">{\r\n  &quot;version&quot;: &quot;0.1.20240422&quot;,\r\n  &quot;status_code&quot;: 20000,\r\n  &quot;status_message&quot;: &quot;Ok.&quot;,\r\n  &quot;time&quot;: &quot;0.1566 sec.&quot;,\r\n  &quot;cost&quot;: 0.02006,\r\n  &quot;tasks_count&quot;: 1,\r\n  &quot;tasks_error&quot;: 0,\r\n  &quot;tasks&quot;: [\r\n    {\r\n      &quot;id&quot;: &quot;04241333-1535-0576-0000-a7b281e5516b&quot;,\r\n      &quot;status_code&quot;: 20000,\r\n      &quot;status_message&quot;: &quot;Ok.&quot;,\r\n      &quot;time&quot;: &quot;0.0989 sec.&quot;,\r\n      &quot;cost&quot;: 0.02006,\r\n      &quot;result_count&quot;: 1,\r\n      &quot;path&quot;: [\r\n        &quot;v3&quot;,\r\n        &quot;backlinks&quot;,\r\n        &quot;bulk_pages_summary&quot;,\r\n        &quot;live&quot;\r\n      ],\r\n      &quot;data&quot;: {\r\n        &quot;api&quot;: &quot;backlinks&quot;,\r\n        &quot;function&quot;: &quot;bulk_pages_summary&quot;,\r\n        &quot;targets&quot;: [\r\n          &quot;https:\/\/dataforseo.com\/solutions&quot;,\r\n          &quot;https:\/\/dataforseo.com\/about-us&quot;\r\n        ]\r\n      },\r\n      &quot;result&quot;: [\r\n        {\r\n          &quot;total_count&quot;: 2,\r\n          &quot;items_count&quot;: 2,\r\n          &quot;items&quot;: [\r\n            {\r\n              &quot;type&quot;: &quot;backlinks_page_summary&quot;,\r\n              &quot;url&quot;: &quot;https:\/\/dataforseo.com\/solutions&quot;,\r\n              &quot;rank&quot;: 0,\r\n              &quot;main_domain_rank&quot;: 419,\r\n              &quot;backlinks&quot;: 0,\r\n              &quot;first_seen&quot;: null,\r\n              &quot;lost_date&quot;: null,\r\n              &quot;backlinks_spam_score&quot;: 0,\r\n              &quot;broken_backlinks&quot;: 0,\r\n              &quot;broken_pages&quot;: 0,\r\n              &quot;referring_domains&quot;: 0,\r\n              &quot;referring_domains_nofollow&quot;: 0,\r\n              &quot;referring_main_domains&quot;: 0,\r\n              &quot;referring_main_domains_nofollow&quot;: 0,\r\n              &quot;referring_ips&quot;: 0,\r\n              &quot;referring_subnets&quot;: 0,\r\n              &quot;referring_pages&quot;: 0,\r\n              &quot;referring_pages_nofollow&quot;: 0,\r\n              &quot;referring_links_tld&quot;: null,\r\n              &quot;referring_links_types&quot;: null,\r\n              &quot;referring_links_attributes&quot;: null,\r\n              &quot;referring_links_platform_types&quot;: null,\r\n              &quot;referring_links_semantic_locations&quot;: null,\r\n              &quot;referring_links_countries&quot;: null\r\n            },\r\n            {\r\n              &quot;type&quot;: &quot;backlinks_page_summary&quot;,\r\n              &quot;url&quot;: &quot;https:\/\/dataforseo.com\/about-us&quot;,\r\n              &quot;rank&quot;: 0,\r\n              &quot;main_domain_rank&quot;: 419,\r\n              &quot;backlinks&quot;: 3,\r\n              &quot;first_seen&quot;: &quot;2024-03-31 07:06:04 +00:00&quot;,\r\n              &quot;lost_date&quot;: null,\r\n              &quot;backlinks_spam_score&quot;: 5,\r\n              &quot;broken_backlinks&quot;: 0,\r\n              &quot;broken_pages&quot;: 0,\r\n              &quot;referring_domains&quot;: 1,\r\n              &quot;referring_domains_nofollow&quot;: 0,\r\n              &quot;referring_main_domains&quot;: 1,\r\n              &quot;referring_main_domains_nofollow&quot;: 0,\r\n              &quot;referring_ips&quot;: 1,\r\n              &quot;referring_subnets&quot;: 1,\r\n              &quot;referring_pages&quot;: 3,\r\n              &quot;referring_pages_nofollow&quot;: 0,\r\n              &quot;referring_links_tld&quot;: {\r\n                &quot;com&quot;: 3\r\n              },\r\n              &quot;referring_links_types&quot;: {\r\n                &quot;anchor&quot;: 3\r\n              },\r\n              &quot;referring_links_attributes&quot;: null,\r\n              &quot;referring_links_platform_types&quot;: {\r\n                &quot;unknown&quot;: 3\r\n              },\r\n              &quot;referring_links_semantic_locations&quot;: {\r\n                &quot;&quot;: 3\r\n              },\r\n              &quot;referring_links_countries&quot;: {\r\n                &quot;&quot;: 3\r\n              }\r\n            }\r\n          ]\r\n        }\r\n      ]\r\n    }\r\n  ]\r\n}<\/code><\/pre><\/div><\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"<p>[vc_row][vc_column][vc_column_text] Bulk Pages Summary &thinsp; 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. [\/vc_column_text] POST https:\/\/api.dataforseo.com\/v3\/backlinks\/bulk_pages_summary\/live Pricing [&hellip;]<\/p>\n","protected":false},"author":14,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","footnotes":""},"class_list":["post-18752","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/18752","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=18752"}],"version-history":[{"count":31,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/18752\/revisions"}],"predecessor-version":[{"id":21359,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/18752\/revisions\/21359"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=18752"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}