Skip to main content
GET
/
api
/
v1
/
projects
/
{projectId}
/
sources
curl --request GET \
  --url 'https://app.finseo.ai/api/v1/projects/67a1c2d3e4f5061728394a5b/sources?timeframe=30d&sortBy=citations' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'
{
  "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.
projectId
string
required
Project identifier.
timeframe
string
default:"30d"
Rolling window for citations.
model
string
Filter by answer model.
language
string
Filter prompts by language.
tags
string
JSON array or comma-separated prompt tags.
Match domain or title substring.
sortBy
string
default:"citations"
One of citations, domain, type.
sortDir
string
default:"desc"
asc or desc.
page
integer
default:"1"
Page number.
limit
integer
default:"50"
Page size (1–500).
curl --request GET \
  --url 'https://app.finseo.ai/api/v1/projects/67a1c2d3e4f5061728394a5b/sources?timeframe=30d&sortBy=citations' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'
{
  "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
    }
  }
}