curl --request POST \
--url https://api.querying.ai/v1/async/task \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"taskType": "GEMINI",
"idempotencyKey": "job-42:prompt-7:gemini",
"priority": 1,
"webhook": {
"url": "https://your-server.example.com/hook"
},
"payload": {
"prompt": "best wireless earbuds 2026",
"country": "US",
"include": {
"markdown": true
}
}
}
'{
"success": true,
"task": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"taskType": "CHATGPT",
"status": "QUEUED",
"priority": 123,
"createdAt": "2023-11-07T05:31:56Z",
"idempotencyKey": "<string>"
},
"credits": {
"creditsToCharge": 123,
"creditsCharged": 123
}
}Create a task
Queue a single task against one engine.
curl --request POST \
--url https://api.querying.ai/v1/async/task \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"taskType": "GEMINI",
"idempotencyKey": "job-42:prompt-7:gemini",
"priority": 1,
"webhook": {
"url": "https://your-server.example.com/hook"
},
"payload": {
"prompt": "best wireless earbuds 2026",
"country": "US",
"include": {
"markdown": true
}
}
}
'{
"success": true,
"task": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"taskType": "CHATGPT",
"status": "QUEUED",
"priority": 123,
"createdAt": "2023-11-07T05:31:56Z",
"idempotencyKey": "<string>"
},
"credits": {
"creditsToCharge": 123,
"creditsCharged": 123
}
}Authorizations
Your API key, sent as Authorization: Bearer <key>.
Body
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.
CHATGPT, PERPLEXITY, GEMINI, AIMODE, GOOGLE_AIMODE, GOOGLE, GOOGLE_AIO, NAVER_AI_BRIEF, NAVER_AI_TAB, NAVER, SOURCE_INFLUENCE, CITATION_ATTRIBUTION 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.
Show child attributes
Show child attributes
Optional. Deduplicates submissions. Omit for no deduplication. A duplicate is a 409 on this endpoint, but a success on the batch endpoint.
Queue ordering, higher wins. Values outside 1–10 are clamped, not rejected.
1 <= x <= 10Optional. Omit to collect the result by polling instead.
Show child attributes
Show child attributes
Response
Task accepted and queued.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes