Referring Domains of a Website by Domain Score (Rows 1-9 or 10-54)

{
  "type": "object",
  "required": [
    "url",
    "order_by",
    "direction",
    "limit"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "The website to look up, as a root domain without a scheme or path."
    },
    "limit": {
      "enum": [
        9,
        45
      ],
      "type": "integer",
      "default": 9,
      "description": "Number of rows: 9 for the first nine referring domains, or 45 together with offset 9 for the next forty-five."
    },
    "scope": {
      "enum": [
        "ROOT_DOMAIN"
      ],
      "type": "string",
      "default": "ROOT_DOMAIN",
      "description": "What the lookup covers: the whole root domain. The only value offered."
    },
    "offset": {
      "enum": [
        9
      ],
      "type": "integer",
      "description": "Rows to skip: 9, used with limit 45 to get rows 10 to 54. Omit for rows 1 to 9."
    },
    "order_by": {
      "enum": [
        "domain_score"
      ],
      "type": "string",
      "default": "domain_score",
      "description": "Sort field: domain score. The only value offered."
    },
    "direction": {
      "enum": [
        "DESC"
      ],
      "type": "string",
      "default": "DESC",
      "description": "Sort direction: highest first. The only value offered."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "The referring domain."
          },
          "is_new": {
            "type": "boolean",
            "description": "Whether the referring domain is flagged as newly found."
          },
          "is_lost": {
            "type": "boolean",
            "description": "Whether the referring domain is flagged as lost."
          },
          "is_follow": {
            "type": "boolean",
            "description": "Whether links from this domain are follow links, as reported."
          },
          "domain_score": {
            "type": "number",
            "description": "The referring domain's score, from 0 to 100."
          },
          "last_seen_at": {
            "type": "string",
            "description": "When a link from this domain was last seen, as an ISO date-time."
          },
          "first_seen_at": {
            "type": "string",
            "description": "When a link from this domain was first seen, as an ISO date-time."
          },
          "backlinks_count": {
            "type": "number",
            "description": "Number of backlinks from this domain to the looked-up site."
          }
        }
      },
      "description": "Referring domains in descending domain-score order; at most `limit` rows, fewer when the site has fewer."
    }
  },
  "description": "The website's referring domains, as returned after shaping."
}