Lister les prompts

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

params = {"timeframe": "30d", "limit": 10, "page": 1, "search": "Finseo"}
r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params=params,
)
body = r.json()["data"]
print(body["pagination"], body["prompts"][0]["prompt"])

{
  "data": {
    "prompts": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "prompt": "What are the best AI SEO tools including Finseo?",
        "domain": "finseo.ai",
        "brandName": "finseo",
        "language": "en",
        "tags": ["branded", "comparison"],
        "models": ["chatgpt", "claude", "perplexity"],
        "intentScores": { "commercial": 0.82, "informational": 0.64 },
        "searchIntents": ["compare", "evaluate"],
        "isVisible": true,
        "mentions": 14,
        "averagePosition": 18.2,
        "sentimentScore": 0.76,
        "sentimentCategory": "positive",
        "competitorCount": 6,
        "sourceCount": 22,
        "createdAt": "2026-02-10T12:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 48,
      "hasMore": true
    }
  }
}

GET

projects

{projectId}

prompts

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

params = {"timeframe": "30d", "limit": 10, "page": 1, "search": "Finseo"}
r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params=params,
)
body = r.json()["data"]
print(body["pagination"], body["prompts"][0]["prompt"])

{
  "data": {
    "prompts": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "prompt": "What are the best AI SEO tools including Finseo?",
        "domain": "finseo.ai",
        "brandName": "finseo",
        "language": "en",
        "tags": ["branded", "comparison"],
        "models": ["chatgpt", "claude", "perplexity"],
        "intentScores": { "commercial": 0.82, "informational": 0.64 },
        "searchIntents": ["compare", "evaluate"],
        "isVisible": true,
        "mentions": 14,
        "averagePosition": 18.2,
        "sentimentScore": 0.76,
        "sentimentCategory": "positive",
        "competitorCount": 6,
        "sourceCount": 22,
        "createdAt": "2026-02-10T12:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 48,
      "hasMore": true
    }
  }
}

Liste les prompts suivis d’un projet avec la visibilité, le nombre de Mentions et le Sentiment pour la période sélectionnée. Finseo évalue ces prompts sur ChatGPT, Claude, Perplexity et d’autres modèles.

string

requis

Identifiant du projet.

string

défaut:"30d"

Durée de la fenêtre glissante, p. ex. 7d, 30d, 90d.

string

Filtre les résultats sur un seul modèle (p. ex. chatgpt).

string

Filtre par code de langue ISO (p. ex. en, de).

string

Chaîne au format tableau JSON ou noms de Tags séparés par des virgules pour filtrer les prompts.

string

Correspondance de sous-chaîne insensible à la casse sur le texte du prompt.

integer

défaut:"1"

Numéro de page (à partir de 1).

integer

défaut:"50"

Taille de page (1–500).

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

import requests

params = {"timeframe": "30d", "limit": 10, "page": 1, "search": "Finseo"}
r = requests.get(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    params=params,
)
body = r.json()["data"]
print(body["pagination"], body["prompts"][0]["prompt"])

{
  "data": {
    "prompts": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "prompt": "What are the best AI SEO tools including Finseo?",
        "domain": "finseo.ai",
        "brandName": "finseo",
        "language": "en",
        "tags": ["branded", "comparison"],
        "models": ["chatgpt", "claude", "perplexity"],
        "intentScores": { "commercial": 0.82, "informational": 0.64 },
        "searchIntents": ["compare", "evaluate"],
        "isVisible": true,
        "mentions": 14,
        "averagePosition": 18.2,
        "sentimentScore": 0.76,
        "sentimentCategory": "positive",
        "competitorCount": 6,
        "sourceCount": 22,
        "createdAt": "2026-02-10T12:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 48,
      "hasMore": true
    }
  }
}

Mettre à jour un projet Créer un prompt

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Lister les prompts