Skip to main content
POST

Authorizations

Authorization
string
header
required

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

Body

application/json
taskType
enum<string>
required

The engine to query. NAVER is a deprecated alias for NAVER_AI_BRIEF. GOOGLE_AIO and GOOGLE_AIMODE are the unified names for GOOGLE and AIMODE; both spellings are accepted and responses echo the canonical GOOGLE / AIMODE.

Available options:
CHATGPT,
PERPLEXITY,
GEMINI,
AIMODE,
GOOGLE_AIMODE,
GOOGLE,
GOOGLE_AIO,
NAVER_AI_BRIEF,
NAVER_AI_TAB,
NAVER,
SOURCE_INFLUENCE,
CITATION_ATTRIBUTION
payload
object
required

Engine payloads share this envelope. Scraping engines require prompt or query. SOURCE_INFLUENCE (submitted via POST /v1/source-influence; CITATION_ATTRIBUTION is its deprecated alias) requires answer + citations instead.

idempotencyKey
string

Optional. Deduplicates submissions. Omit for no deduplication. A duplicate is a 409 on this endpoint, but a success on the batch endpoint.

priority
integer
default:1

Queue ordering, higher wins. Values outside 1–10 are clamped, not rejected.

Required range: 1 <= x <= 10
webhook
object

Optional. Omit to collect the result by polling instead.

Response

Task accepted and queued.

success
boolean
required
task
object
required
credits
object
required

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 model tokens and source fetches.