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
}
}
Prompts
Create Prompt
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.
string
required
Project identifier.
string
required
Prompt text (1–500 characters).
array
Model identifiers; default
["chatgpt", "claude", "perplexity"].string
default:"en"
Language code for the prompt.
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
}
}
⌘I