AIsa Backlinks

Bulk Backlinks

post_dataforseo_backlinks_bulk_backlinks_live

Destructive

‌ This endpoint will provide you with the number of backlinks pointing to domains, subdomains, and pages specified in the targets array. The returned numbers correspond to all live backlinks, that is, total number of referring links with all attributes (e.g., nofollow, noreferrer, ugc, sponsored etc) that were found during the latest check.

Usage-based billing; Default request estimate: $0.024 USD (not a fixed price). Account-specific pricing and final settlement may differ.

Input Schema

Name	Required	Description	Default
`body`	No

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 19, 2026

changedInput schema / properties / body / items / oneOf

Previous value: -[
-  {
-    "example": [
-      {
-        "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"
-        ]
-      }
-    ],
-    "properties": {
-      "tag": {
-        "description": "<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",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "targets": {
-        "description": "<em>domains, subdomains or webpages to get the number of 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 <code>https://</code> and <code>www.</code><br>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>]`",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "tag": {
+        "description": "<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",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "targets": {
+        "description": "<em>domains, subdomains or webpages to get the number of 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 <code>https://</code> and <code>www.</code><br>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>]`",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]

Changed2 schema fields changedOct 16, 2026

removedInput schema / properties / body / items / anyOf

Removed value: -[
-  {
-    "example": [
-      {
-        "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"
-        ]
-      }
-    ],
-    "properties": {
-      "tag": {
-        "description": "<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",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "targets": {
-        "description": "<em>domains, subdomains or webpages to get the number of 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 <code>https://</code> and <code>www.</code><br>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>]`",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "type": "object"
-  }
-]

addedInput schema / properties / body / items / oneOf

Added value: +[
+  {
+    "example": [
+      {
+        "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"
+        ]
+      }
+    ],
+    "properties": {
+      "tag": {
+        "description": "<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",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "targets": {
+        "description": "<em>domains, subdomains or webpages to get the number of 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 <code>https://</code> and <code>www.</code><br>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>]`",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]

Changed7 schema fields changedOct 15, 2026

addedInput schema / properties / body / example

Added value: +[
+  {
+    "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"
+    ]
+  }
+]

addedInput schema / properties / body / items / anyOf

Added value: +[
+  {
+    "example": [
+      {
+        "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"
+        ]
+      }
+    ],
+    "properties": {
+      "tag": {
+        "description": "<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",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "targets": {
+        "description": "<em>domains, subdomains or webpages to get the number of 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 <code>https://</code> and <code>www.</code><br>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>]`",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]

removedInput schema / properties / body / items / properties

Removed value: -{
-  "tag": {
-    "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
-    "type": "string"
-  },
-  "targets": {
-    "description": "domains, subdomains or webpages to get the number of backlinks for required field you can set up to 1000 domains, subdomains or webpages the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including http:// or https://) example: \"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\" ]",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  }
-}

removedInput schema / properties / body / items / required
```
Removed value: -[
-  "targets"
-]
```

changedInput schema / properties / body / items / type

Previous value: -"object"New value: +[
+  "object",
+  "null"
+]

changedInput schema / required

Previous value: -[
-  "body"
-]New value: +[]

addedOutput schema / x-fastmcp-wrap-result
```
Added value: +true
```

Changed7 schema fields changedOct 15, 2026

removedInput schema / properties / body / example

Removed value: -[
-  {
-    "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"
-    ]
-  }
-]

removedInput schema / properties / body / items / anyOf

Removed value: -[
-  {
-    "example": [
-      {
-        "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"
-        ]
-      }
-    ],
-    "properties": {
-      "tag": {
-        "description": "<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",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "targets": {
-        "description": "<em>domains, subdomains or webpages to get the number of 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 <code>https://</code> and <code>www.</code><br>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>]`",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "type": "object"
-  }
-]

addedInput schema / properties / body / items / properties

Added value: +{
+  "tag": {
+    "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
+    "type": "string"
+  },
+  "targets": {
+    "description": "domains, subdomains or webpages to get the number of backlinks for required field you can set up to 1000 domains, subdomains or webpages the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including http:// or https://) example: \"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\" ]",
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  }
+}

addedInput schema / properties / body / items / required
```
Added value: +[
+  "targets"
+]
```

changedInput schema / properties / body / items / type

Previous value: -[
-  "object",
-  "null"
-]New value: +"object"

changedInput schema / required

Previous value: -[]New value: +[
+  "body"
+]

removedOutput schema / x-fastmcp-wrap-result
```
Removed value: -true
```

Changed7 schema fields changedOct 15, 2026

addedInput schema / properties / body / example

Added value: +[
+  {
+    "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"
+    ]
+  }
+]

addedInput schema / properties / body / items / anyOf

Added value: +[
+  {
+    "example": [
+      {
+        "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"
+        ]
+      }
+    ],
+    "properties": {
+      "tag": {
+        "description": "<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",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "targets": {
+        "description": "<em>domains, subdomains or webpages to get the number of 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 <code>https://</code> and <code>www.</code><br>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>]`",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]

removedInput schema / properties / body / items / properties

Removed value: -{
-  "tag": {
-    "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
-    "type": "string"
-  },
-  "targets": {
-    "description": "domains, subdomains or webpages to get the number of backlinks for required field you can set up to 1000 domains, subdomains or webpages the domain or subdomain should be specified without https:// and www. the page should be specified with absolute URL (including http:// or https://) example: \"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\" ]",
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  }
-}

removedInput schema / properties / body / items / required
```
Removed value: -[
-  "targets"
-]
```

changedInput schema / properties / body / items / type

Previous value: -"object"New value: +[
+  "object",
+  "null"
+]

changedInput schema / required

Previous value: -[
-  "body"
-]New value: +[]

addedOutput schema / x-fastmcp-wrap-result
```
Added value: +true
```

First observedSep 15, 2026

TDQS

A3.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnlyHint=false, destructiveHint=true, idempotentHint=false, openWorldHint=true), so the bar is lower. The description still adds real context beyond that: the figures are counts of ALL live backlinks including every attribute (nofollow, noreferrer, ugc, sponsored) and reflect the latest check, which directly shapes interpretation of the result. The embedded billing note also flags cost, a behavioral trait annotations do not carry. Rate limits/auth are not mentioned, keeping it from a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core purpose is front-loaded in the first sentence and the second sentence adds genuinely useful clarification about what the counts include. The stray zero-width characters and the templated pricing block add minor noise, but overall it is tight and readable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter live endpoint with an output schema, the description covers the essential ground: what is returned and how to interpret it. Return value structure is handled by the output schema, so it need not explain it. The main gap is absent routing guidance against the many sibling backlinks endpoints.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description points at the targets array and clarifies it accepts domains, subdomains, and pages, which is meaningful. It says nothing about the tag identifier, the 1000-target limit, or the domain-vs-absolute-URL formatting rules. The reported schema coverage is 0% at the top level, so the description does not fully compensate, though the schema's nested field descriptions carry most of the format detail.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource: it returns the 'number of backlinks' for domains, subdomains, and pages in the targets array. This distinguishes it from list-style siblings like post_dataforseo_backlinks_backlinks_live (which returns actual backlinks) and scopes it to counts. However, it never explicitly contrasts itself with the many other backlinks siblings (anchors, referring_domains, summary), so differentiation is left to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use or when-not-to-use guidance, no named alternative, and no prerequisites. An agent must infer from the name and sibling list why it would pick this bulk endpoint over the single-target backlinks_live or the bulk_* variants. Pricing boilerplate is present but is not usage guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AIsa Backlinks tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?