CiteLadder · Schema

PromptMetricItem

Artificial IntelligenceVisibilitySearchCitationsAnalytics

Properties

Name Type Description
id string
audit_id string
prompt_id object
prompt_index integer
prompt_text string
prompt_snapshot_id object
cohort string
composite_score numbernull
source_audit_ids array
previous_score numbernull
immediate_delta numbernull
rolling_four array
per_engine_scores object
components object
engine_agreement number
repetition_agreement number
evidence_coverage number
trend_confidence number
decline_confirmed boolean
analyzer_version string
scoring_rule_version string
created_at string
theme string
intent string
visibility_rate numbernull
owned_citation_rate numbernull
avg_position numbernull
visibility_delta numbernull
comparison_status string
comparison object
counts object
answer_states object
action_id object
outcomes array
View JSON Schema on GitHub

JSON Schema

citeladder-com-prompt-metric-item-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/citeladder-com/json-schema/citeladder-com-prompt-metric-item-schema.json",
  "title": "PromptMetricItem",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/citeladder-com-openapi.json#/components/schemas/PromptMetricItem",
  "type": "object",
  "properties": {
    "id": {
      "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)$"
    },
    "audit_id": {
      "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)$"
    },
    "prompt_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"
        }
      ]
    },
    "prompt_index": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "prompt_text": {
      "type": "string"
    },
    "prompt_snapshot_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"
        }
      ]
    },
    "cohort": {
      "type": "string"
    },
    "composite_score": {
      "type": [
        "number",
        "null"
      ]
    },
    "source_audit_ids": {
      "type": "array",
      "items": {
        "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)$"
      }
    },
    "previous_score": {
      "type": [
        "number",
        "null"
      ]
    },
    "immediate_delta": {
      "type": [
        "number",
        "null"
      ]
    },
    "rolling_four": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "per_engine_scores": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "number"
      }
    },
    "components": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "number",
          "null"
        ]
      }
    },
    "engine_agreement": {
      "type": "number"
    },
    "repetition_agreement": {
      "type": "number"
    },
    "evidence_coverage": {
      "type": "number"
    },
    "trend_confidence": {
      "type": "number"
    },
    "decline_confirmed": {
      "type": "boolean"
    },
    "analyzer_version": {
      "type": "string"
    },
    "scoring_rule_version": {
      "type": "string"
    },
    "created_at": {
      "type": "string"
    },
    "theme": {
      "type": "string"
    },
    "intent": {
      "type": "string"
    },
    "visibility_rate": {
      "type": [
        "number",
        "null"
      ]
    },
    "owned_citation_rate": {
      "type": [
        "number",
        "null"
      ]
    },
    "avg_position": {
      "type": [
        "number",
        "null"
      ]
    },
    "visibility_delta": {
      "type": [
        "number",
        "null"
      ]
    },
    "comparison_status": {
      "type": "string"
    },
    "comparison": {
      "anyOf": [
        {
          "$ref": "#/$defs/VisibilityComparison"
        },
        {
          "type": "null"
        }
      ]
    },
    "counts": {
      "$ref": "#/$defs/MeasurementCounts"
    },
    "answer_states": {
      "anyOf": [
        {
          "$ref": "#/$defs/AnswerStates"
        },
        {
          "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"
        }
      ]
    },
    "outcomes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "logical_engine": {
            "type": "string"
          },
          "transport_model": {
            "type": "string"
          },
          "counts": {
            "$ref": "#/$defs/MeasurementCounts"
          },
          "visibility_rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "owned_citation_rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "answer_states": {
            "anyOf": [
              {
                "$ref": "#/$defs/AnswerStates"
              },
              {
                "type": "null"
              }
            ]
          },
          "gap_counts": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            }
          }
        },
        "required": [
          "logical_engine",
          "transport_model",
          "counts",
          "visibility_rate",
          "owned_citation_rate",
          "gap_counts"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "id",
    "audit_id",
    "prompt_id",
    "prompt_index",
    "prompt_text",
    "cohort",
    "composite_score",
    "previous_score",
    "immediate_delta",
    "rolling_four",
    "per_engine_scores",
    "components",
    "engine_agreement",
    "repetition_agreement",
    "evidence_coverage",
    "trend_confidence",
    "decline_confirmed",
    "analyzer_version",
    "scoring_rule_version",
    "created_at"
  ],
  "additionalProperties": false,
  "$defs": {
    "AnswerStates": {
      "type": "object",
      "properties": {
        "mentioned_and_cited": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "mentioned_only": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "cited_only": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "neither": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "mentioned_and_cited",
        "mentioned_only",
        "cited_only",
        "neither"
      ],
      "additionalProperties": false
    },
    "MeasurementCounts": {
      "type": "object",
      "properties": {
        "state": {
          "type": "string"
        },
        "responses": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "brand_responses": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "owned_citation_responses": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "entity_presences": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "expected": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "failed": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "not_run": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "state",
        "responses",
        "brand_responses",
        "owned_citation_responses",
        "entity_presences",
        "expected",
        "failed",
        "not_run"
      ],
      "additionalProperties": false
    },
    "RankingRow": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "is_brand": {
          "type": "boolean"
        },
        "logo_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "website_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "mention_rate": {
          "type": [
            "number",
            "null"
          ]
        },
        "citation_rate": {
          "type": [
            "number",
            "null"
          ]
        },
        "share_of_voice": {
          "type": [
            "number",
            "null"
          ]
        },
        "mention_count": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "visibility_delta": {
          "type": [
            "number",
            "null"
          ]
        },
        "gap_count": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "matched_visibility_rate": {
          "type": [
            "number",
            "null"
          ]
        },
        "matched_visibility_delta": {
          "type": [
            "number",
            "null"
          ]
        },
        "matched_response_count": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "avg_position": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "name",
        "is_brand",
        "mention_rate",
        "citation_rate",
        "share_of_voice",
        "mention_count",
        "avg_position"
      ],
      "additionalProperties": false
    },
    "VisibilityComparison": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string"
        },
        "baseline_audit_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"
            }
          ]
        },
        "baseline_audit_ids": {
          "type": "array",
          "items": {
            "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)$"
          }
        },
        "baseline_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "baseline_counts": {
          "anyOf": [
            {
              "$ref": "#/$defs/MeasurementCounts"
            },
            {
              "type": "null"
            }
          ]
        },
        "current_counts": {
          "anyOf": [
            {
              "$ref": "#/$defs/MeasurementCounts"
            },
            {
              "type": "null"
            }
          ]
        },
        "deltas": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "rankings": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/RankingRow"
          }
        },
        "skipped_runs": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "matched_cells": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "current_cells": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "baseline_cells": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "current_values": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "baseline_values": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "current_rankings": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/RankingRow"
          }
        }
      },
      "required": [
        "status",
        "baseline_audit_id",
        "baseline_audit_ids",
        "baseline_at",
        "baseline_counts",
        "current_counts",
        "deltas",
        "rankings",
        "skipped_runs",
        "matched_cells",
        "current_cells",
        "baseline_cells",
        "current_values",
        "baseline_values",
        "current_rankings"
      ],
      "additionalProperties": false
    }
  }
}

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-prompt-metric-item"
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.