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

Liste les domaines et URL cités dans les réponses IA pour vos prompts suivis — utile pour comprendre quelles sources génèrent de la visibilité pour les requêtes liées à Finseo sur ChatGPT, Claude et Perplexity.

string

requis

Identifiant du projet.

string

défaut:"30d"

Fenêtre glissante pour les Citations.

string

Filtre par modèle de réponse.

string

Filtre les prompts par langue.

string

Tableau JSON ou Tags de prompts séparés par des virgules.

string

Correspondance de sous-chaîne sur le domaine ou le titre.

string

défaut:"citations"

L’une des valeurs citations, domain, type.

string

défaut:"desc"

asc ou desc.

integer

défaut:"1"

Numéro de page.

integer

défaut:"50"

Taille de page (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
    }
  }
}

Lister les concurrents Lister les tags

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Lister les sources