AIsa Backlinks

Bulk Referring Domains

post_dataforseo_backlinks_bulk_referring_domains_live

Destructive

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

Usage-based billing; Default request estimate: $0.0254 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 referring domains 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 referring domains 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 referring domains 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 referring domains 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 referring domains 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 referring domains 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 referring domains 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 referring domains 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 referring domains 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 referring domains 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

C2.8/5.0

Behavior1/5

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

The description frames a pure data-retrieval query ('will provide you with the number...'), which is incompatible with the annotations declaring destructiveHint=true and readOnlyHint=false. It also omits rate limits, auth needs, and the 1000-target ceiling. The one genuine disclosure — that counts cover all live referring domains regardless of link type (nofollow, ugc, sponsored) as of the latest check — does not offset the behavioral-profile contradiction.

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?

Two front-loaded sentences that lead with the tool's function, followed by a short billing note. No filler or repetition; the only mild bloat is the pricing boilerplate, which is at least actionable.

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

Completeness3/5

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

An output schema exists, so return-value explanation is not required, and the description adequately covers what data is produced. It is still incomplete for a mutation-annotated, open-world endpoint: no usage routing, no auth/limit context, and the destructive/read-only mismatch is left unaddressed.

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?

Schema coverage is reported at 0% for the top level, so the description must carry the load; it names the 'targets array' and clarifies that domains, subdomains, and pages can be supplied, which is the most important semantic. However it says nothing about the `tag` identifier, the 1000-target limit, or the URL-formatting rules (no https://www. for domains, absolute URL for pages), so it only partially compensates.

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?

States a specific verb and resource: it returns the number of referring domains for the domains/subdomains/pages in the targets array. This clearly distinguishes it from anchor or backlink endpoints, but it never differentiates itself from its closest sibling, post_dataforseo_backlinks_referring_domains_live (the non-bulk variant) or post_dataforseo_backlinks_bulk_new_lost_ref_domains_live, so the 'bulk' scope advantage is left implicit.

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 guidance, no mention of prerequisites (auth/API key), and no named alternative. The description only says what the endpoint returns, leaving the agent to infer when this beats the single-target referring-domains endpoint or the new/lost variant.

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?