Elenca i Prompt

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

Elenca i Prompt tracciati di un progetto con visibilità, numero di Mentions e Sentiment per il periodo selezionato. Finseo valuta questi Prompt su ChatGPT, Claude, Perplexity e altri modelli.

string

obbligatorio

Identificatore del progetto.

string

predefinito:"30d"

Durata della finestra mobile, es. 7d, 30d, 90d.

string

Filtra i risultati su un singolo modello (es. chatgpt).

string

Filtro per codice lingua ISO (es. en, de).

string

Stringa array JSON o nomi di Tag separati da virgola per filtrare i Prompt.

string

Corrispondenza per sottostringa sul testo del Prompt, senza distinzione tra maiuscole e minuscole.

integer

predefinito:"1"

Numero di pagina (a partire da 1).

integer

predefinito:"50"

Dimensione della pagina (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
    }
  }
}

Aggiorna un progetto Crea un Prompt

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Elenca i Prompt