CiteLadder · Schema

VisibilitySources

Artificial IntelligenceVisibilitySearchCitationsAnalytics

Properties

Name Type Description
previous_cursor stringnull
total integer
responses integer
prompts integer
total_citations integer
category_totals object
next_cursor stringnull
as_of string
comparison_status string
retrieval object
items array
View JSON Schema on GitHub

JSON Schema

citeladder-com-visibility-sources-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/citeladder-com/json-schema/citeladder-com-visibility-sources-schema.json",
  "title": "VisibilitySources",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/citeladder-com-openapi.json#/components/schemas/VisibilitySources",
  "type": "object",
  "properties": {
    "previous_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "responses": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "prompts": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "total_citations": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "category_totals": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "as_of": {
      "type": "string"
    },
    "comparison_status": {
      "type": "string"
    },
    "retrieval": {
      "type": "object",
      "properties": {
        "responses": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "unavailable_engines": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "responses",
        "unavailable_engines"
      ],
      "additionalProperties": false
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "retrieved": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "responses": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "prompts": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "annotations": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "urls": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "response_rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "prompt_coverage": {
            "type": [
              "number",
              "null"
            ]
          },
          "retrieval_rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "citation_share": {
            "type": [
              "number",
              "null"
            ]
          },
          "citation_rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "ownership": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "taxonomy_versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "category_unavailable": {
            "type": "boolean"
          },
          "response_delta": {
            "type": [
              "number",
              "null"
            ]
          },
          "url_hash": {
            "type": [
              "string",
              "null"
            ]
          },
          "inspection_state": {
            "type": [
              "string",
              "null"
            ]
          },
          "opportunity_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "standing": {
            "anyOf": [
              {
                "$ref": "#/$defs/PageStanding"
              },
              {
                "type": "null"
              }
            ]
          },
          "action_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "page_format": {
            "type": [
              "string",
              "null"
            ]
          },
          "page_format_method": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_cited_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "mentions": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "brands": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "enum": [
                    "brand",
                    "competitor"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "responses": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                "logo_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "website": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "kind",
                "name",
                "responses",
                "logo_url",
                "website"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "key",
          "retrieved",
          "responses",
          "prompts",
          "annotations",
          "urls",
          "response_rate",
          "prompt_coverage",
          "retrieval_rate",
          "citation_share",
          "citation_rate",
          "ownership",
          "categories",
          "taxonomy_versions",
          "category_unavailable",
          "response_delta",
          "url_hash",
          "inspection_state",
          "opportunity_id",
          "standing",
          "action_id",
          "title",
          "page_format",
          "page_format_method",
          "last_cited_at",
          "mentions",
          "brands"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "total",
    "responses",
    "prompts",
    "total_citations",
    "next_cursor",
    "as_of",
    "comparison_status",
    "retrieval",
    "items"
  ],
  "additionalProperties": false,
  "$defs": {
    "PageStanding": {
      "type": "string",
      "enum": [
        "yours",
        "competitor",
        "blocked",
        "unreadable",
        "not_read",
        "gap",
        "listed",
        "read"
      ]
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/citeladder-com-visibility-sources"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.