Get prompt snapshot
Get an aggregated snapshot of mention and citation analytics for a specific prompt over a date range. Use this to identify competitive gaps, track brand visibility trends, and discover top cited URLs.
Get an aggregated snapshot of mention and citation analytics for a specific prompt over a date range. Use this to identify competitive gaps, track brand visibility trends, and discover top cited URLs.
Authorization
BearerAuth AuthorizationBearer <token>
Bearer API token for access
In: header
Path Parameters
promptId*string
The ID of the prompt
Format
uuidQuery Parameters
startDate*string
Start of date range (YYYY-MM-DD)
Format
dateendDate*string
End of date range (YYYY-MM-DD)
Format
datekMentions?integer
Number of top competitor entities to return in mentionsTopK
Default
5Range
1 <= value <= 50kCitations?integer
Number of top cited URLs to return in citedUrlsTopK
Default
10Range
1 <= value <= 50Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08/snapshot?startDate=2026-01-08&endDate=2026-01-15"{ "brandId": "brand_nike", "promptId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "promptValue": "best running shoes for marathon training", "startDate": "2026-01-08", "endDate": "2026-01-15", "mentions": { "mentionsTotal": 210, "brandMentionsTotal": 42, "competitorMentionsTotal": 130, "mentionsTopK": [ { "entity": "Adidas", "count": 58 }, { "entity": "New Balance", "count": 45 }, { "entity": "ASICS", "count": 27 } ] }, "citations": { "citationsTotal": 1240, "brandCitationsTotal": 85, "competitorCitationsTotal": 620, "citedUrlsTopK": [ { "url": "https://www.runnersworld.com/gear/best-running-shoes/", "title": "Best Running Shoes 2026", "count": 72 }, { "url": "https://www.nike.com/running/marathon", "title": "Nike Marathon Collection", "count": 34 } ] }}{ "error": "string", "message": "string"}{ "error": "string", "message": "string"}{ "error": "string", "message": "string"}{ "error": "string", "message": "string"}