Referring Domains Live

{
  "$defs": {
    "BacklinksReferringDomainsLiveRequestInfo": {
      "properties": {
        "backlinks_filters": {
          "anyOf": [
            {
              "description": "filter the backlinks of your targetoptional fieldyou can use this field to filter the initial backlinks that will be included in the dataset for aggregated metrics for your targetyou can filter the backlinks by all fields available in the response of this endpointusing this parameter, you can include only dofollow backlinks in the response and create a flexible backlinks dataset to calculate the metrics forexample:\"backlinks_filters\": [\"dofollow\", \"=\", true]",
              "items": {
                "anyOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "backlinks_status_type": {
          "anyOf": [
            {
              "description": "set what backlinks to return and countoptional fieldyou can use this field to choose what backlinks will be returned and used for aggregated metrics for your target;possible values: all - all backlinks will be returned and counted;live - backlinks found during the last check will be returned and counted;lost - lost backlinks will be returned and counted;default value: live",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "exclude_internal_backlinks": {
          "anyOf": [
            {
              "description": "indicates whether the backlinks from subdomains of the target are excludedoptional fieldif set to false, the backlinks from subdomains of the target will be ommited and you won't receive the same domain in the response;default value: true",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "filters": {
          "anyOf": [
            {
              "description": "array of results filtering parametersoptional fieldyou can add several filters at once (8 filters maximum)you should set a logical operator and, or between the conditionsthe following operators are supported:regex, not_regex, =, <>, in, not_in, like, not_like, match, not_matchyou can use the % operator with like and not_like to match any string of zero or more charactersexample:[\"referring_pages\",\">\",\"1\"][[\"referring_pages\",\">\",\"2\"],\"and\",[\"backlinks\",\">\",\"10\"]][[\"first_seen\",\">\",",
              "items": {
                "anyOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "include_indirect_links": {
          "anyOf": [
            {
              "description": "indicates if indirect links to the target will be included in the resultsoptional fieldif set to true, the results will include data on indirect links pointing to a page that either redirects to the target, or points to a canonical pageif set to false, indirect links will be ignoreddefault value: true",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "include_subdomains": {
          "anyOf": [
            {
              "description": "indicates if the subdomains of the target will be included in the searchoptional fieldif set to false, the subdomains will be ignoreddefault value: true",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "internal_list_limit": {
          "anyOf": [
            {
              "description": "maximum number of elements within internal arraysoptional fieldyou can use this field to limit the number of elements within the following arrays:referring_links_tldreferring_links_typesreferring_links_attributesreferring_links_platform_typesreferring_links_semantic_locationsdefault value: 10maximum value: 1000",
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "limit": {
          "anyOf": [
            {
              "description": "the maximum number of returned domainsoptional fielddefault value: 100maximum value: 1000",
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "offset": {
          "anyOf": [
            {
              "description": "offset in the results array of returned domainsoptional fielddefault value: 0if you specify the 10 value, the first ten domains in the results array will be omitted and the data will be provided for the successive pages",
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "order_by": {
          "anyOf": [
            {
              "description": "results sorting rulesoptional fieldyou can use the same values as in the filters array to sort the resultspossible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending orderyou should use a comma to set up a sorting typeexample:[\"backlinks,desc\"]note that you can set no more than three sorting rules in a single requestyou should use a comma to separate several sorting rulesexample:[\"backlinks,desc\",\"rank,asc\"]",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "rank_scale": {
          "anyOf": [
            {
              "description": "defines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank valuesoptional fieldyou can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scalepossible values:one_hundred — rank values are displayed on a 0–100 scaleone_thousand — rank values are displayed on a 0–1000 scaledefault value: one_thousandlearn more about how this parameter works and how ranking metrics are calculated in this Help Center article",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "tag": {
          "anyOf": [
            {
              "description": "user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "target": {
          "description": "domain, subdomain or webpage to get referring domains forrequired fielda domain or a subdomain should be specified without and www.a page should be specified with absolute URL (including or",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "body": {
      "items": {
        "anyOf": [
          {
            "oneOf": [
              {
                "$ref": "#/$defs/BacklinksReferringDomainsLiveRequestInfo"
              }
            ],
            "type": "object"
          },
          {
            "type": "null"
          }
        ]
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}