> ## 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.

# Get run results

> Return per-prompt analysis results for a specific run.

Returns one record per prompt/LLM combination: presence, sentiment, rank, mentioned brands, and optionally the full LLM response text.

### Path parameters

<ParamField path="runId" type="string" required>
  Run UUID. Obtain from [List runs](/api-reference/runs/list).
</ParamField>

### Query parameters

<ParamField query="include_answer" default="false" type="boolean">
  Set to `true` to include the raw LLM response text in each result. Significantly increases response size.
</ParamField>

<ParamField query="limit" default="50" type="integer">
  Items per page. Maximum 500.
</ParamField>

<ParamField query="page" default="1" type="integer">
  Page number (1-based).
</ParamField>

### Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -s \
    -H "x-spotlight-api-key: YOUR_API_KEY" \
    "https://app.get-spotlight.com/api/v1/runs/RUN_ID?include_answer=false&limit=50&page=1"
  ```

  ```python Python theme={null}
  import requests

  r = requests.get(
      "https://app.get-spotlight.com/api/v1/runs/RUN_ID",
      headers={"x-spotlight-api-key": "YOUR_API_KEY"},
      params={"include_answer": "false", "limit": 50, "page": 1},
  )
  print(r.json())
  ```

  ```javascript JavaScript theme={null}
  const url = new URL("https://app.get-spotlight.com/api/v1/runs/RUN_ID");
  url.searchParams.set("include_answer", "false");
  url.searchParams.set("limit", "50");

  const r = await fetch(url, {
    headers: { "x-spotlight-api-key": "YOUR_API_KEY" },
  });
  const json = await r.json();
  ```
</CodeGroup>

### Response

<ResponseField name="run" type="object">
  Basic run metadata.

  <Expandable title="Run" />
</ResponseField>

<ResponseField name="data" type="Result[]">
  Per-prompt analysis results.

  <Expandable title="Result object">
    <ResponseField name="prompt" type="object">
      <Expandable title="Prompt" />
    </ResponseField>

    <ResponseField name="topic" type="object">
      <Expandable title="Topic" />
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "run": { "id": "run-uuid-123", "brandId": "brand-uuid-123", "startedAt": "2025-02-01T10:00:00Z" },
  "data": [
    {
      "id": "result-uuid-1",
      "runId": "run-uuid-123",
      "prompt": { "text": "What do customers say about pricing?", "journeyStage": "consideration" },
      "topic": { "name": "Pricing" },
      "llm": "chatgpt",
      "isPresent": true,
      "rank": 1,
      "sentiment": "positive",
      "mentionedBrands": ["competitor-x"]
    }
  ],
  "paging": { "page": 1, "limit": 50, "total": 200, "nextPage": 2 },
  "includeAnswer": false
}
```