Skip to main content
POST

Autorisations

Authorization
string
header
requis

Your API key, sent as Authorization: Bearer <key>.

Corps

application/json
answer
string
requis

Required unless taskId is sent. The AI answer to analyze, as raw markdown (keep link fragments intact). 1-200,000 characters at submission; the analysis itself has a smaller per-answer processing budget, and an answer above it fails explicitly instead of being truncated.

Required string length: 1 - 200000
citations
object[]
requis

Required unless taskId is sent. 1-100 sources, at most 10 discussion-thread URLs. Total HTTP body <=1 MiB.

Maximum array length: 100
taskId
string

Instead of answer and citations: the id of one of your COMPLETED answer tasks that is still readable through GET /v1/async/task/{id}. Its answer Markdown (text when there is none) becomes answer, and its cited URLs become citations in the engine's order (first 100, at most 10 discussion threads). Its prompt, country and engine are used unless you send them. Sending taskId together with answer or citations is a 400; an unknown or expired id is a 404.

Maximum string length: 128
prompt
string

Compatibility context for existing integrations; not returned in the result.

Maximum string length: 200000
country
string
engine
string

Compatibility context for existing integrations; not returned in the result.

Maximum string length: 64
brand
string

Compatibility context for existing integrations; not returned in the result.

Maximum string length: 200
competitors
string[]

Compatibility context for existing integrations (up to 25 names); not returned in the result.

Maximum array length: 25
Maximum string length: 200
idempotencyKey
string
priority
integer
webhook
object

Réponse

Queued; poll /v1/async/task/{id}. Its response follows SourceInfluenceResult.

success
boolean
requis
task
object
requis
credits
object
requis

Submit and polling envelopes preserve zero values. With billing enabled, account settlement uses the engine pricing policy; webhooks report the persisted charge. SOURCE_INFLUENCE is metered by actual usage.