Skip to main content
GET
/
v1
/
runs
/
{runId}
/
stats
Get run stats
curl --request GET \
  --url https://api.example.com/v1/runs/{runId}/stats
{
  "metrics": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.get-spotlight.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns the same metrics object available in the runs list, but for a single run by ID. Useful when you already know the runId and want metrics without fetching the full list.

​
Path parameters

​
runId
string
required
The run UUID. Obtain it from List runs.

​
Request

curl -s \
  -H "x-spotlight-api-key: YOUR_API_KEY" \
  "https://app.get-spotlight.com/api/v1/runs/RUN_ID/stats"

​
Response

​
metrics
object
See the metrics schema in List runs.
{
  "id": "run-uuid-123",
  "brandId": "brand-uuid-123",
  "startedAt": "2025-02-01T10:00:00Z",
  "metrics": {
    "present": 120,
    "positive": 80,
    "negative": 20,
    "neutral": 20,
    "responsesWithBrands": 100,
    "totalResponses": 150,
    "completedResponses": 150,
    "averageRank": 1.8,
    "mentionedBrandsRun": {
      "competitor-x": 45,
      "competitor-y": 30
    },
    "topics": {
      "Pricing": { "present": 40, "positive": 30 },
      "Support": { "present": 30, "negative": 5 }
    },
    "calculatedAt": "2025-02-01T10:30:00Z"
  }
}