Skip to main content
GET
/
v1
/
runs
/
{runId}
/
sources
Get run sources
curl --request GET \
  --url https://api.example.com/v1/runs/{runId}/sources
{
  "run": {},
  "data": [
    {
      "links": [
        {}
      ]
    }
  ]
}

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.

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

​
runId
string
required
Run UUID. Obtain from List runs.

​
Request

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

​
Response

​
run
object
​
data
DomainGroup[]
Domains sorted by responseCount descending.
{
  "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 }
      ]
    }
  ]
}