Get run sources
curl --request GET \
--url https://api.example.com/v1/runs/{runId}/sourcesimport requests
url = "https://api.example.com/v1/runs/{runId}/sources"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/runs/{runId}/sources', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/runs/{runId}/sources",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/runs/{runId}/sources"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/runs/{runId}/sources")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/runs/{runId}/sources")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"run": {},
"data": [
{
"links": [
{}
]
}
]
}Sources
Get run sources
Return the URLs that LLMs cited during a specific run, grouped by domain.
GET
/
v1
/
runs
/
{runId}
/
sources
Get run sources
curl --request GET \
--url https://api.example.com/v1/runs/{runId}/sourcesimport requests
url = "https://api.example.com/v1/runs/{runId}/sources"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/runs/{runId}/sources', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/runs/{runId}/sources",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/runs/{runId}/sources"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/runs/{runId}/sources")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/runs/{runId}/sources")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"run": {},
"data": [
{
"links": [
{}
]
}
]
}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
Request
curl -s \
-H "x-spotlight-api-key: YOUR_API_KEY" \
"https://app.rocketblue.ai/api/v1/runs/RUN_ID/sources"
import requests
r = requests.get(
"https://app.rocketblue.ai/api/v1/runs/RUN_ID/sources",
headers={"x-spotlight-api-key": "YOUR_API_KEY"},
)
print(r.json())
Response
object
Show Run
Show Run
DomainGroup[]
Domains sorted by
responseCount descending.Show DomainGroup object
Show DomainGroup object
Link[]
Individual URLs under this domain.
Show Link object
Show Link object
{
"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 }
]
}
]
}
⌘I

