curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/sources?timeframe=30d&sortBy=citations' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/sources",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "search": "finseo", "limit": 25},
)
print(r.json()["data"]["sources"][0]["domain"])
{
"data": {
"sources": [
{
"id": "e9f0a1b2-c3d4-4657-ef01-890123456cde",
"url": "https://finseo.ai/blog/ai-visibility",
"domain": "finseo.ai",
"title": "AI Visibility Benchmarks — Finseo",
"sourceType": "website",
"urlType": "content",
"citationCount": 89,
"promptCount": 34,
"averagePosition": 2.1
},
{
"id": "f0a1b2c3-d4e5-4768-f012-901234567def",
"url": "https://www.reddit.com/r/SEO/comments/example",
"domain": "reddit.com",
"title": "Discussion on AI SEO tools",
"sourceType": "community",
"urlType": "ugc",
"citationCount": 41,
"promptCount": 18,
"averagePosition": 4.6
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 120,
"hasMore": true
}
}
}
Sources
List Sources
GET
/
v1
/
projects
/
{projectId}
/
sources
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/sources?timeframe=30d&sortBy=citations' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/sources",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "search": "finseo", "limit": 25},
)
print(r.json()["data"]["sources"][0]["domain"])
{
"data": {
"sources": [
{
"id": "e9f0a1b2-c3d4-4657-ef01-890123456cde",
"url": "https://finseo.ai/blog/ai-visibility",
"domain": "finseo.ai",
"title": "AI Visibility Benchmarks — Finseo",
"sourceType": "website",
"urlType": "content",
"citationCount": 89,
"promptCount": 34,
"averagePosition": 2.1
},
{
"id": "f0a1b2c3-d4e5-4768-f012-901234567def",
"url": "https://www.reddit.com/r/SEO/comments/example",
"domain": "reddit.com",
"title": "Discussion on AI SEO tools",
"sourceType": "community",
"urlType": "ugc",
"citationCount": 41,
"promptCount": 18,
"averagePosition": 4.6
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 120,
"hasMore": true
}
}
}
Lists domains and URLs cited in AI answers for your tracked prompts—useful for understanding which sources drive visibility for Finseo-related queries across ChatGPT, Claude, and Perplexity.
string
required
Project identifier.
string
default:"30d"
Rolling window for citations. Ignored when
startDate/endDate are set.string
Custom range start (
YYYY-MM-DD). Must be combined with endDate; overrides timeframe.string
Custom range end (
YYYY-MM-DD). Must be combined with startDate.string
Filter by answer model.
string
Filter prompts by language.
string
JSON array or comma-separated prompt tags.
string
Match domain or title substring.
string
default:"citations"
One of
citations, domain, type.string
default:"desc"
asc or desc.integer
default:"1"
Page number.
integer
default:"50"
Page size (1–500).
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/sources?timeframe=30d&sortBy=citations' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/sources",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "search": "finseo", "limit": 25},
)
print(r.json()["data"]["sources"][0]["domain"])
{
"data": {
"sources": [
{
"id": "e9f0a1b2-c3d4-4657-ef01-890123456cde",
"url": "https://finseo.ai/blog/ai-visibility",
"domain": "finseo.ai",
"title": "AI Visibility Benchmarks — Finseo",
"sourceType": "website",
"urlType": "content",
"citationCount": 89,
"promptCount": 34,
"averagePosition": 2.1
},
{
"id": "f0a1b2c3-d4e5-4768-f012-901234567def",
"url": "https://www.reddit.com/r/SEO/comments/example",
"domain": "reddit.com",
"title": "Discussion on AI SEO tools",
"sourceType": "community",
"urlType": "ugc",
"citationCount": 41,
"promptCount": 18,
"averagePosition": 4.6
}
],
"pagination": {
"page": 1,
"limit": 25,
"total": 120,
"hasMore": true
}
}
}