elmo
DiscordGitHubTry DemoGet Started

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
/prompts/{promptId}/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.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer API token for access

In: header

Path Parameters

promptId*string

The ID of the prompt

Formatuuid

Query Parameters

startDate*string

Start of date range (YYYY-MM-DD)

Formatdate
endDate*string

End of date range (YYYY-MM-DD)

Formatdate
kMentions?integer

Number of top competitor entities to return in mentionsTopK

Default5
Range1 <= value <= 50
kCitations?integer

Number of top cited URLs to return in citedUrlsTopK

Default10
Range1 <= value <= 50

Response 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"}