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

> Return the URLs that LLMs cited during a specific run, grouped by domain.

Sources answer the question: **"Where did this information come from?"** They are the external URLs that LLMs referenced when analyzing your brand. Results are grouped by domain and sorted by number of responses.

Use this data to:

* Identify which websites most influence your brand's AI visibility
* Find high-impact pages to update or promote
* Build source attribution dashboards

### Path parameters

<ParamField path="runId" type="string" required>
  Run UUID. Obtain from [List runs](/api-reference/runs/list).
</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/sources"
  ```

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

  r = requests.get(
      "https://app.get-spotlight.com/api/v1/runs/RUN_ID/sources",
      headers={"x-spotlight-api-key": "YOUR_API_KEY"},
  )
  print(r.json())
  ```
</CodeGroup>

### Response

<ResponseField name="run" type="object">
  <Expandable title="Run" />
</ResponseField>

<ResponseField name="data" type="DomainGroup[]">
  Domains sorted by `responseCount` descending.

  <Expandable title="DomainGroup object">
    <ResponseField name="links" type="Link[]">
      Individual URLs under this domain.

      <Expandable title="Link object" />
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "run": { "id": "run-uuid-123", "brandId": "brand-uuid-123", "startedAt": "2025-02-01T10:00:00Z" },
  "data": [
    {
      "domain": "example.com",
      "urlCount": 3,
      "responseCount": 12,
      "topics": ["Pricing", "Support"],
      "llms": ["chatgpt", "gemini"],
      "links": [
        { "uri": "https://example.com/blog/post-1", "type": "article", "responseCount": 7 },
        { "uri": "https://example.com/reviews", "type": "review", "responseCount": 5 }
      ]
    }
  ]
}
```
