backlinks_referring_domains

Analyze referring domains and backlinks for a specified target domain, subdomain, or webpage. Filter, sort, and retrieve data to optimize SEO strategies and monitor link-building performance.

Instructions

This endpoint will provide you with a detailed overview of referring domains pointing to the target you specify

Input Schema

Name	Required	Description
`filters`	No	array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match you can use the % operator with like and not_like to match any string of zero or more characters example: ["meta.internal_links_count",">","1"] [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]] [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
`limit`	No	the maximum number of returned pages
`offset`	No	offset in the results array of returned pages optional field default value: 0 if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages
`order_by`	No	results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc – results will be sorted in the ascending order desc – results will be sorted in the descending order you should use a comma to set up a sorting type example: ["page_summary.backlinks,desc"] note that you can set no more than three sorting rules in a single request you should use a comma to separate several sorting rules example: ["page_summary.backlinks,desc","page_summary.rank,asc"]
`target`	Yes	domain, subdomain or webpage to get backlinks for required field a domain or a subdomain should be specified without https:// and www. a page should be specified with absolute URL (including http:// or https://)

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "filters": {
      "anyOf": [
        {
          "items": [
            {
              "type": "string"
            },
            {
              "enum": [
                "regex",
                "not_regex",
                "<",
                "<=",
                ">",
                ">=",
                "=",
                "<>",
                "in",
                "not_in",
                "ilike",
                "not_ilike",
                "like",
                "not_like"
              ],
              "type": "string"
            },
            {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                },
                {
                  "type": "array"
                }
              ]
            }
          ],
          "maxItems": 3,
          "minItems": 3,
          "type": "array"
        },
        {
          "items": {
            "anyOf": [
              {
                "$ref": "#/properties/filters"
              },
              {
                "enum": [
                  "and",
                  "or"
                ],
                "type": "string"
              }
            ]
          },
          "maxItems": 7,
          "type": "array"
        }
      ],
      "description": "array of results filtering parameters\noptional field\nyou can add several filters at once (8 filters maximum)\nyou should set a logical operator and, or between the conditions\nthe following operators are supported:\nregex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match\nyou can use the % operator with like and not_like to match any string of zero or more characters\nexample:\n[\"meta.internal_links_count\",\">\",\"1\"]\n[[\"meta.external_links_count\",\">\",\"2\"],\n\"and\",\n[\"backlinks\",\">\",\"10\"]]\n\n[[\"first_visited\",\">\",\"2017-10-23 11:31:45 +00:00\"],\n\"and\",\n[[\"title\",\"like\",\"%seo%\"],\"or\",[\"referring_domains\",\">\",\"10\"]]]"
    },
    "limit": {
      "default": 10,
      "description": "the maximum number of returned pages",
      "maximum": 1000,
      "minimum": 1,
      "type": "number"
    },
    "offset": {
      "description": "offset in the results array of returned pages\noptional field\ndefault value: 0\nif you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages",
      "minimum": 0,
      "type": "number"
    },
    "order_by": {
      "description": "results sorting rules\noptional field\nyou can use the same values as in the filters array to sort the results\npossible sorting types:\nasc – results will be sorted in the ascending order\ndesc – results will be sorted in the descending order\nyou should use a comma to set up a sorting type\nexample:\n[\"page_summary.backlinks,desc\"]\nnote that you can set no more than three sorting rules in a single request\nyou should use a comma to separate several sorting rules\nexample:\n[\"page_summary.backlinks,desc\",\"page_summary.rank,asc\"]",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "target": {
      "description": "domain, subdomain or webpage to get backlinks for\n        required field\na domain or a subdomain should be specified without https:// and www.\na page should be specified with absolute URL (including http:// or https://)",
      "type": "string"
    }
  },
  "required": [
    "target"
  ],
  "type": "object"
}

DataForSEO MCP Server

backlinks_referring_domains

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from DataForSEO MCP Server

Related Tools

MCP directory API