elmo
Sign up

Get prompt snapshot

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
headerAuthorizationBearer <token>

An instance admin key from ADMIN_API_KEYS, or an organization key (elmo_…) issued from the dashboard.

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

Range1 <= value <= 50
Default5
kCitations?integer

Number of top cited URLs to return in citedUrlsTopK

Range1 <= value <= 50
Default10

Response Body

Prompt snapshot with mention and citation analytics

application/json
  1. response
brandId*string

Brand identifier this prompt belongs to

promptId*string

Unique identifier for the prompt

Formatuuid
promptValue*string

The prompt text

startDate*string

Start of the queried date range (YYYY-MM-DD)

Formatdate
endDate*string

End of the queried date range (YYYY-MM-DD)

Formatdate
mentions*

Aggregated mention counts for a prompt across its evaluation runs.

sentiment*

Experimental — the shape may still change.

Answers that mention the company, by the mention judge's sentiment toward it. An answer that only links to the company counts in none. All zero for history the judge hasn't re-judged yet. Counted over every answer in the window, unlike visibility.current and the share-of-voice mentions and share, which count each prompt's latest result.

position*

Experimental — the shape may still change.

The company's position among the tracked companies the answers name, 1 being named first. Companies that aren't tracked aren't ranked. Counted over every answer in the window, unlike visibility.current and the share-of-voice mentions and share, which count each prompt's latest result.

citations*
Example Request
curl -X GET 'https://app.elmohq.com/api/v1/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08/snapshot?startDate=2026-01-08&endDate=2026-01-15'
Example Response
{
  "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
      }
    ]
  },
  "sentiment": {
    "positive": 96,
    "neutral": 31,
    "negative": 4,
    "mixed": 2,
    "score": 0.85
  },
  "position": {
    "average": 1.6
  },
  "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
      }
    ]
  }
}