Sign in
Backlinks

Changed on

‌ This endpoint will provide you with the number of new and lost backlinks for the domains, subdomains, and pages specified in the targets array.

post/v3/backlinks/bulk_new_lost_backlinks/live

Request

  • Base URL: https://api.dataforseo.com
  • URL: https://api.dataforseo.com/v3/backlinks/bulk_new_lost_backlinks/live
  • Auth: HTTP basic

Request body

targetsstring[]

<em>domains, subdomains or webpages to get new & lost backlinks for</em><br><strong>required field</strong><br>you can set up to 1000 domains, subdomains or webpages<br>the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including <code>http://</code> or <code>https://</code>)<br>example:<br> "targets": [<br> "forbes.com",<br> "cnn.com",<br> "bbc.com",<br> "yelp.com",<br> "https://www.apple.com/iphone/",<br> "https://ahrefs.com/blog/",<br> "ibm.com",<br> "https://variety.com/",<br> "https://stackoverflow.com/",<br> "www.trustpilot.com"<br>]

date_fromstring nullable

<em>starting date of the time range</em><br>optional field<br>this field indicates the date which will be used as a threshold for new and lost backlinks;<br>the backlinks that appeared in our index after the specified date will be considered as new;<br>the backlinks that weren't found after the specified date, but were present before, will be considered as lost;<p>default value: today's date -(minus) one month;<br>e.g. if today is <code>2021-10-13</code>, default <code>date_from</code> will be <code>2021-09-13</code>.<br><strong>minimum value equals today's date -(minus) one year;</strong><br>e.g. if today is <code>2021-10-13</code>, minimum <code>date_from</code> will be <code>2020-10-13</code>.<p>date format: <code>"yyyy-mm-dd"</code><br>example:<br><code>"2021-01-01"</code>

tagstring nullable

<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response

Example request

[
  {
    "targets": [
      "forbes.com",
      "cnn.com",
      "bbc.com",
      "yelp.com",
      "https://www.apple.com/iphone/",
      "https://ahrefs.com/blog/",
      "ibm.com",
      "https://variety.com/",
      "https://stackoverflow.com/",
      "www.trustpilot.com"
    ],
    "date_from": "2026-09-12 05:48:19"
  }
]

Response

Successful operation

versionstring nullable

the current version of the API

status_codeinteger nullable

general status code you can find the full list of the response codes here

status_messagestring nullable

general informational message you can find the full list of general informational messages here

timestring nullable

total execution time, seconds

costnumber double nullable

total tasks cost, USD

tasks_countinteger nullable

the number of tasks in the tasks array

tasks_errorinteger nullable

the number of tasks in the tasks array returned with an error

Changes

  • be20fca9d9ccRevision changes
    • info

      api operation id BacklinksBulkNewLostBacklinksLive removed and replaced with BulkNewLostBacklinksLive

  • e73495840d61Revision changes
    • info

      api operation id BulkNewLostBacklinksLive removed and replaced with BacklinksBulkNewLostBacklinksLive