Referring domains for a target

{
  "operationId": "referring_domains",
  "method": "post",
  "path": "/referring-domains",
  "summary": "Referring domains for a target",
  "description": "Lists the domains linking to a target, each with rank, backlink count, first/last seen dates and spam score. This is the outreach-prospecting call: the sites already linking to a competitor are the sites most likely to link to you. Cost scales with rows; default 100 is right for most pulls.",
  "parameters": [],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "target"
          ],
          "properties": {
            "target": {
              "type": "string",
              "description": "Domain, subdomain or full page URL to list referring domains for."
            },
            "limit": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 100,
              "description": "Max referring domains to return. Default 100. Cost scales with rows."
            },
            "offset": {
              "type": "integer",
              "minimum": 0,
              "description": "Pagination offset."
            },
            "exclude_internal_backlinks": {
              "type": "boolean",
              "default": true,
              "description": "Ignore links from the target to itself. Default true."
            },
            "filters": {
              "type": "array",
              "items": {},
              "description": "Optional filter expression as [field, operator, value] triples. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like. Recipe: [[\"rank\",\">\",100]] keeps stronger referring domains (rank is the referring domain's authority, higher is better)."
            },
            "order_by": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Sort rules, e.g. [\"rank,desc\"]."
            }
          }
        },
        "example": {
          "target": "competitor.com",
          "limit": 100,
          "order_by": [
            "rank,desc"
          ]
        }
      }
    }
  },
  "responses": [
    {
      "statusCode": "200",
      "description": "Referring domains with metrics in `result[0].items`.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object"
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Bad request or upstream task error."
    },
    {
      "statusCode": "401",
      "description": "Unauthorized."
    },
    {
      "statusCode": "429",
      "description": "Too many requests."
    },
    {
      "statusCode": "5XX",
      "description": "Upstream error."
    }
  ]
}