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

> Return URLs cited in perception responses for a specific run, grouped by domain.

Perception sources are the external URLs that LLMs referenced when generating perception scores. They are grouped by domain and sorted by response count — like [Get run sources](/api-reference/sources/get-run-sources), but specific to the perception layer.

In addition to topics and LLMs, each domain group lists the **perception properties** (e.g. `"Trust"`, `"Ease of use"`) that those sources contributed to.

### Path parameters

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

### Request

```bash theme={null}
curl -s \
  -H "x-spotlight-api-key: YOUR_API_KEY" \
  "https://app.get-spotlight.com/api/v1/runs/RUN_ID/perception-sources"
```

### 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[]">
      <Expandable title="Link" />
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={null}
{
  "run": { "id": "run-uuid-123", "brandId": "brand-uuid-123", "startedAt": "2025-02-01T10:00:00Z", "completedAt": "2025-02-01T11:00:00Z" },
  "data": [
    {
      "domain": "reviews.example.com",
      "urlCount": 2,
      "responseCount": 6,
      "properties": ["Trust", "Ease of use"],
      "llms": ["chatgpt"],
      "links": [
        { "uri": "https://reviews.example.com/post-1", "type": "review", "responseCount": 4 }
      ]
    }
  ]
}
```