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
}
}创建任务
针对一个引擎排入单个任务。
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
}
}授权
Your API key, sent as Authorization: Bearer <key>.
请求体
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. GOOGLE_SERP returns the Google results page without the AI Overview; payload.page selects pages 1-10. NAVER_SERP returns Naver's web results, 15 per page (payload.page 1-10), and with payload.action page reads one naver.com page by payload.url. REDDIT searches Reddit posts by query (optionally within one subreddit), reads one post with its first page of comments by url, or lists posts with action feed or user_posts. BING and BING_COPILOT_SEARCH are accepted as earlier spellings of BING_SEARCH, and COPILOT as the earlier spelling of BING_COPILOT; responses echo the new names. SOURCE_INFLUENCE and PROMPT_RESEARCH tasks are created through their own endpoints (POST /v1/source-influence, POST /v1/prompt-research); they appear here because their tasks report them.
CHATGPT, PERPLEXITY, GEMINI, AIMODE, GOOGLE_AIMODE, GOOGLE, GOOGLE_AIO, GOOGLE_SERP, NAVER_AI_BRIEF, NAVER_AI_TAB, NAVER, NAVER_SERP, BING_SEARCH, BING, BING_COPILOT, COPILOT, REDDIT, SOURCE_INFLUENCE, CITATION_ATTRIBUTION, PROMPT_RESEARCH Engine payloads share this envelope. Scraping engines require prompt or query. SOURCE_INFLUENCE has its own endpoint (POST /v1/source-influence, with answer and citations at the top level; CITATION_ATTRIBUTION is its deprecated alias) and is rejected here with 400 USE_DEDICATED_ENDPOINT.
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.
Compatibility field; does not guarantee execution order. 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
响应
Task accepted and queued.