Metrics

Get AI-visibility trust metrics for an application

Retrieve aggregated AI-visibility audit results for the tracked products of an application: current per-axis scores, movement since each product's baseline audit, and a weekly history. Backed by the persisted weekly audit snapshots — no live scraping happens on this call.

get/v1/admin/metrics/trust

Request

  • Base URL: https://api.prod.keyban.io
  • URL: https://api.prod.keyban.io/v1/admin/metrics/trust
  • Auth: X-Api-Key (a scheme the document does not define)

Query parameters

startDatestring date
Example:2026-01-01

Start date of the metrics period (inclusive, format: YYYY-MM-DD). Defaults to 30 days before endDate if omitted.

endDatestring date
Example:2026-01-31

End date of the metrics period (inclusive, format: YYYY-MM-DD). Defaults to today if omitted.

applicationIdstring uuid

Optional application UUID to scope metrics to a single application

Response

Trust metrics retrieved successfully

applicationIdstring uuid required

Application the metrics are scoped to. Trust audits track one application's product catalogue, so this is never aggregated across applications.

sampleSizeinteger required

Number of tracked products (audit subjects) currently active for this application — recruited, baseline captured, and re-audited weekly. This is the population current, deltaSinceBaseline and series are computed over. Subjects still awaiting their baseline, or archived, are excluded.

quotaUsedinteger required

Non-archived audit subjects across the whole organization (all applications, including baseline_pending) — the same tally the recruitment quota is checked against. Wider than sampleSize: it is organization-scoped, not application-scoped, and it counts subjects not yet active.

quotaLimitinteger required

Maximum non-archived audit subjects the organization may hold across all its applications before recruitment stops (OrganizationQuotas.trustAuditLimit, defaulting to 10 when the organization has no explicit override).

currentobject required

Per-axis mean, across every active subject, of that subject's most recent snapshot within the queried date range. An axis is null when no active subject has a snapshot inside the range — not the same as a score of 0.

deltaSinceBaselineinteger nullable required

Mean, over active subjects that carry both a baseline snapshot and a snapshot within the queried range, of (latest geo score − baseline geo score). Subjects recruited without a captured baseline yet are excluded from the average, not treated as a zero movement. Null when no subject qualifies.

Example response

{
  "applicationId": "550e8400-e29b-41d4-a716-446655440000",
  "sampleSize": 42,
  "quotaUsed": 57,
  "quotaLimit": 10,
  "current": {
    "visibility": 62,
    "competitive": 48,
    "technicalReadiness": 71,
    "answerability": 55,
    "geo": 61
  },
  "deltaSinceBaseline": 9,
  "series": [
    {
      "weekStart": "2026-07-06",
      "axes": {
        "visibility": 60,
        "competitive": 45,
        "technicalReadiness": 70,
        "answerability": 52,
        "geo": 58
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.