Skip to main content
POST
/
v1
/
projects
/
{projectId}
/
prompts
curl --request POST \
  --url https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "How does Finseo compare to traditional SEO suites?",
    "models": ["chatgpt", "claude", "perplexity"],
    "language": "en",
    "tags": ["comparison", "Finseo"]
  }'

import requests

payload = {
    "prompt": "How does Finseo compare to traditional SEO suites?",
    "models": ["chatgpt", "claude", "perplexity"],
    "language": "en",
    "tags": ["comparison", "Finseo"],
}
r = requests.post(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    json=payload,
)
print(r.json()["data"])

{
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "prompt": "How does Finseo compare to traditional SEO suites?",
    "domain": "finseo.ai",
    "brandName": "finseo",
    "language": "en",
    "models": ["chatgpt", "claude", "perplexity"],
    "tags": ["comparison", "Finseo"],
    "created": true
  }
}
Adds a new tracking prompt to a project. Finseo will run this prompt on the specified models and record visibility for your brand vs competitors across ChatGPT, Claude, and Perplexity.
​
projectId
string
required
Project identifier.
​
prompt
string
required
Prompt text (1–500 characters).
​
models
array
Model identifiers; default ["chatgpt", "claude", "perplexity"].
​
language
string
default:"en"
Language code for the prompt.
​
tags
array
Optional string tags for filtering in analytics.
curl --request POST \
  --url https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "How does Finseo compare to traditional SEO suites?",
    "models": ["chatgpt", "claude", "perplexity"],
    "language": "en",
    "tags": ["comparison", "Finseo"]
  }'

import requests

payload = {
    "prompt": "How does Finseo compare to traditional SEO suites?",
    "models": ["chatgpt", "claude", "perplexity"],
    "language": "en",
    "tags": ["comparison", "Finseo"],
}
r = requests.post(
    "https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
    headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
    json=payload,
)
print(r.json()["data"])

{
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "prompt": "How does Finseo compare to traditional SEO suites?",
    "domain": "finseo.ai",
    "brandName": "finseo",
    "language": "en",
    "models": ["chatgpt", "claude", "perplexity"],
    "tags": ["comparison", "Finseo"],
    "created": true
  }
}