List Sources

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/sources?timeframe=30d&sortBy=citations' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

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
    }
  }
}

GET

projects

{projectId}

sources

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/sources?timeframe=30d&sortBy=citations' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

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 sk_live_xxxxxxxx'

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
    }
  }
}

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Tasks

Export

Attribution