Trust

Rank AI-visibility audit prompts

Rank the prompts of the latest audit of every active tracked product, best-performing first: where the catalogue surfaces best in generative-engine answers, per prompt and per shopping intent (generic purchase intents and proof-seeking intents such as origin or certification). intents (comma-separated) keeps only the given intent families; omitted, every prompt is ranked and total counts them all. Each item names the leader of its prompt: the tracked product itself when its best rank across the engines ties the best rank seen (the same reading as bestRank), otherwise the best-ranked competitor domain; null on snapshots captured before leaders were recorded.

get/v1/trust/audit/prompts

Request

  • Base URL: https://api.prod.keyban.io
  • URL: https://api.prod.keyban.io/v1/trust/audit/prompts
  • Auth: API key in header X-Api-Key

Query parameters

applicationIdstring uuid required
Example:550e8400-e29b-41d4-a716-446655440000

UUID of the application owning the tracked products. Must belong to the authenticated organization.

limitinteger
Example:10

Max number of prompts to return, best-performing first.

offsetinteger

Number of prompts to skip before this page.

intentsstring[]

Shopping intents to keep, comma-separated (quality,origin) or repeated (intents=quality&intents=origin), among category, brand, comparison, problem, quality, origin, warranty, certification. Omit to rank every prompt.

[
  "certification"
]

Response

totalinteger required

Total prompts available across the latest snapshots, independent of limit/offset.

limitinteger required

Page size applied (echo of the request).

offsetinteger required

Number of prompts skipped before this page (echo of the request).

Example response

{
  "data": [
    {
      "text": "Quelle canne à carpe choisir pour débuter, autour de 3,60 m ?",
      "intent": "certification",
      "subjectId": "550e8400-e29b-41d4-a716-446655440000",
      "passportId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "productName": "Recycled cotton hoodie",
      "visibility": 100,
      "competitive": 42,
      "bestRank": 2,
      "leader": {
        "domain": "competitor-brand.example"
      },
      "auditedAt": "2026-08-31T08:00:00.000Z"
    }
  ],
  "total": 126,
  "limit": 10
}

Changes

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