Backlink Profile Summary (Domain, Subdomain, Subfolder, or Page)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Target to query: a domain ('example.com') or full URL ('https://example.com/page'), with or without the protocol."
    },
    "scope": {
      "enum": [
        "ROOT_DOMAIN",
        "SUBDOMAIN",
        "SUBFOLDER",
        "PAGE"
      ],
      "type": "string",
      "default": "ROOT_DOMAIN",
      "description": "Which part of the target the query covers: ROOT_DOMAIN (default), SUBDOMAIN, SUBFOLDER, or PAGE."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "This data source's error code for a target with no indexed backlink profile, observed as the literal string 'NOT_FOUND' on the one settled not-found call captured -- absent on a successful call."
    },
    "data": {
      "type": "object",
      "properties": {
        "score": {
          "type": "integer",
          "description": "This data source's own 0-100 authority score for the target. Observed as 100 (the maximum) on the one real call captured (wikipedia.org's root domain) -- the low end of the range is unconfirmed."
        },
        "ips_count": {
          "type": "integer",
          "description": "Distinct referring IP addresses."
        },
        "new_count": {
          "type": "integer",
          "description": "Backlinks this data source has recently detected as newly added."
        },
        "ugc_count": {
          "type": "integer",
          "description": "Backlinks marked rel=ugc (user-generated content, e.g. forum or comment links)."
        },
        "lost_count": {
          "type": "integer",
          "description": "Backlinks this data source has detected as removed."
        },
        "urls_count": {
          "type": "integer",
          "description": "Distinct referring pages (URLs)."
        },
        "forms_count": {
          "type": "integer",
          "description": "Backlinks embedded via a form element."
        },
        "texts_count": {
          "type": "integer",
          "description": "Backlinks that are plain text anchor links."
        },
        "frames_count": {
          "type": "integer",
          "description": "Backlinks embedded via an iframe rather than a plain anchor link."
        },
        "images_count": {
          "type": "integer",
          "description": "Backlinks that are image links rather than text links."
        },
        "domains_count": {
          "type": "integer",
          "description": "Distinct referring domains."
        },
        "follows_count": {
          "type": "integer",
          "description": "Backlinks that pass SEO authority (dofollow)."
        },
        "backlinks_count": {
          "type": "integer",
          "description": "Total backlinks pointing at the target."
        },
        "nofollows_count": {
          "type": "integer",
          "description": "Backlinks marked nofollow."
        },
        "sponsored_count": {
          "type": "integer",
          "description": "Backlinks marked rel=sponsored (paid or advertising links)."
        },
        "ip_class_c_count": {
          "type": "integer",
          "description": "Distinct referring IP class-C subnets -- a rough proxy for hosting/network diversity among referrers."
        }
      },
      "description": "Present when the target resolved to an indexed backlink profile.",
      "additionalProperties": true
    },
    "type": {
      "type": "string",
      "description": "The result kind, observed as the literal string 'backlinks_overview' on the one real call captured."
    },
    "message": {
      "type": "string",
      "description": "A human-readable message accompanying `code` on a not-found call, observed as 'Not found: HTTP 404' on the one settled not-found call captured -- absent on a successful call."
    }
  },
  "description": "The backlink profile summary, as returned at routing.responseResultPath ($.output). A target with no indexed backlink profile (see examples/example-subfolder.json) returns the error envelope (`code`, `message`) instead of a populated `data` object -- no field below is guaranteed present on every call.",
  "additionalProperties": true
}