Create tasks in bulk
curl --request POST \
--url https://api.querying.ai/v1/async/task/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"taskType": "GEMINI",
"idempotencyKey": "job-42:p1:gemini",
"payload": {
"prompt": "best wireless earbuds 2026"
}
},
{
"taskType": "PERPLEXITY",
"idempotencyKey": "job-42:p1:perplexity",
"payload": {
"prompt": "best wireless earbuds 2026"
}
},
{
"taskType": "GOOGLE",
"idempotencyKey": "job-42:p1:google",
"payload": {
"query": "best wireless earbuds 2026"
}
}
]
'import requests
url = "https://api.querying.ai/v1/async/task/batch"
payload = [
{
"taskType": "GEMINI",
"idempotencyKey": "job-42:p1:gemini",
"payload": { "prompt": "best wireless earbuds 2026" }
},
{
"taskType": "PERPLEXITY",
"idempotencyKey": "job-42:p1:perplexity",
"payload": { "prompt": "best wireless earbuds 2026" }
},
{
"taskType": "GOOGLE",
"idempotencyKey": "job-42:p1:google",
"payload": { "query": "best wireless earbuds 2026" }
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
taskType: 'GEMINI',
idempotencyKey: 'job-42:p1:gemini',
payload: {prompt: 'best wireless earbuds 2026'}
},
{
taskType: 'PERPLEXITY',
idempotencyKey: 'job-42:p1:perplexity',
payload: {prompt: 'best wireless earbuds 2026'}
},
{
taskType: 'GOOGLE',
idempotencyKey: 'job-42:p1:google',
payload: {query: 'best wireless earbuds 2026'}
}
])
};
fetch('https://api.querying.ai/v1/async/task/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.querying.ai/v1/async/task/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'taskType' => 'GEMINI',
'idempotencyKey' => 'job-42:p1:gemini',
'payload' => [
'prompt' => 'best wireless earbuds 2026'
]
],
[
'taskType' => 'PERPLEXITY',
'idempotencyKey' => 'job-42:p1:perplexity',
'payload' => [
'prompt' => 'best wireless earbuds 2026'
]
],
[
'taskType' => 'GOOGLE',
'idempotencyKey' => 'job-42:p1:google',
'payload' => [
'query' => 'best wireless earbuds 2026'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.querying.ai/v1/async/task/batch"
payload := strings.NewReader("[\n {\n \"taskType\": \"GEMINI\",\n \"idempotencyKey\": \"job-42:p1:gemini\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"PERPLEXITY\",\n \"idempotencyKey\": \"job-42:p1:perplexity\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"GOOGLE\",\n \"idempotencyKey\": \"job-42:p1:google\",\n \"payload\": {\n \"query\": \"best wireless earbuds 2026\"\n }\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.querying.ai/v1/async/task/batch")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"taskType\": \"GEMINI\",\n \"idempotencyKey\": \"job-42:p1:gemini\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"PERPLEXITY\",\n \"idempotencyKey\": \"job-42:p1:perplexity\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"GOOGLE\",\n \"idempotencyKey\": \"job-42:p1:google\",\n \"payload\": {\n \"query\": \"best wireless earbuds 2026\"\n }\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.querying.ai/v1/async/task/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"taskType\": \"GEMINI\",\n \"idempotencyKey\": \"job-42:p1:gemini\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"PERPLEXITY\",\n \"idempotencyKey\": \"job-42:p1:perplexity\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"GOOGLE\",\n \"idempotencyKey\": \"job-42:p1:google\",\n \"payload\": {\n \"query\": \"best wireless earbuds 2026\"\n }\n }\n]"
response = http.request(request)
puts response.read_body{
"success": true,
"summary": {
"total": 3,
"succeeded": 2,
"failed": 1
},
"results": [
{
"success": true,
"index": 0,
"task": {
"id": "8f2c1e40-0000-0000-0000-000000000000",
"taskType": "GEMINI",
"status": "QUEUED",
"priority": 1,
"createdAt": "2026-07-09T04:12:00.000Z",
"idempotencyKey": "job-42:p1:gemini"
},
"credits": {
"creditsToCharge": 0,
"creditsCharged": 0
}
},
{
"success": false,
"index": 1,
"error": {
"code": "REGION_UNAVAILABLE",
"message": "cannot serve region 'DE': no live IPs provisioned. Check GET /capacity.",
"timestamp": "2026-07-09T04:12:00.000Z"
}
},
{
"success": true,
"index": 2,
"task": {
"id": "1b7d9c22-0000-0000-0000-000000000000",
"taskType": "GOOGLE",
"status": "QUEUED",
"priority": 1,
"createdAt": "2026-07-09T04:12:00.000Z",
"idempotencyKey": "job-42:p1:google"
},
"credits": {
"creditsToCharge": 0,
"creditsCharged": 0
}
}
]
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": [
{
"field": "",
"message": "Too small: expected array to have >=1 items"
}
],
"timestamp": "2026-07-09T04:12:00.000Z"
}
}{
"success": false,
"error": {
"code": "MISSING_API_KEY",
"message": "Missing or invalid API key",
"timestamp": "2026-07-09T04:12:00.000Z"
}
}{
"success": false,
"error": {
"code": "PAYLOAD_TOO_LARGE",
"message": "batch body exceeds 8388608 bytes",
"timestamp": "2026-07-09T04:12:00.000Z"
}
}Tareas
Crear tareas en lote
Encola hasta 500 tareas en una solicitud, mezclando motores libremente.
POST
/
v1
/
async
/
task
/
batch
Create tasks in bulk
curl --request POST \
--url https://api.querying.ai/v1/async/task/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"taskType": "GEMINI",
"idempotencyKey": "job-42:p1:gemini",
"payload": {
"prompt": "best wireless earbuds 2026"
}
},
{
"taskType": "PERPLEXITY",
"idempotencyKey": "job-42:p1:perplexity",
"payload": {
"prompt": "best wireless earbuds 2026"
}
},
{
"taskType": "GOOGLE",
"idempotencyKey": "job-42:p1:google",
"payload": {
"query": "best wireless earbuds 2026"
}
}
]
'import requests
url = "https://api.querying.ai/v1/async/task/batch"
payload = [
{
"taskType": "GEMINI",
"idempotencyKey": "job-42:p1:gemini",
"payload": { "prompt": "best wireless earbuds 2026" }
},
{
"taskType": "PERPLEXITY",
"idempotencyKey": "job-42:p1:perplexity",
"payload": { "prompt": "best wireless earbuds 2026" }
},
{
"taskType": "GOOGLE",
"idempotencyKey": "job-42:p1:google",
"payload": { "query": "best wireless earbuds 2026" }
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
taskType: 'GEMINI',
idempotencyKey: 'job-42:p1:gemini',
payload: {prompt: 'best wireless earbuds 2026'}
},
{
taskType: 'PERPLEXITY',
idempotencyKey: 'job-42:p1:perplexity',
payload: {prompt: 'best wireless earbuds 2026'}
},
{
taskType: 'GOOGLE',
idempotencyKey: 'job-42:p1:google',
payload: {query: 'best wireless earbuds 2026'}
}
])
};
fetch('https://api.querying.ai/v1/async/task/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.querying.ai/v1/async/task/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'taskType' => 'GEMINI',
'idempotencyKey' => 'job-42:p1:gemini',
'payload' => [
'prompt' => 'best wireless earbuds 2026'
]
],
[
'taskType' => 'PERPLEXITY',
'idempotencyKey' => 'job-42:p1:perplexity',
'payload' => [
'prompt' => 'best wireless earbuds 2026'
]
],
[
'taskType' => 'GOOGLE',
'idempotencyKey' => 'job-42:p1:google',
'payload' => [
'query' => 'best wireless earbuds 2026'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.querying.ai/v1/async/task/batch"
payload := strings.NewReader("[\n {\n \"taskType\": \"GEMINI\",\n \"idempotencyKey\": \"job-42:p1:gemini\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"PERPLEXITY\",\n \"idempotencyKey\": \"job-42:p1:perplexity\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"GOOGLE\",\n \"idempotencyKey\": \"job-42:p1:google\",\n \"payload\": {\n \"query\": \"best wireless earbuds 2026\"\n }\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.querying.ai/v1/async/task/batch")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"taskType\": \"GEMINI\",\n \"idempotencyKey\": \"job-42:p1:gemini\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"PERPLEXITY\",\n \"idempotencyKey\": \"job-42:p1:perplexity\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"GOOGLE\",\n \"idempotencyKey\": \"job-42:p1:google\",\n \"payload\": {\n \"query\": \"best wireless earbuds 2026\"\n }\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.querying.ai/v1/async/task/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"taskType\": \"GEMINI\",\n \"idempotencyKey\": \"job-42:p1:gemini\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"PERPLEXITY\",\n \"idempotencyKey\": \"job-42:p1:perplexity\",\n \"payload\": {\n \"prompt\": \"best wireless earbuds 2026\"\n }\n },\n {\n \"taskType\": \"GOOGLE\",\n \"idempotencyKey\": \"job-42:p1:google\",\n \"payload\": {\n \"query\": \"best wireless earbuds 2026\"\n }\n }\n]"
response = http.request(request)
puts response.read_body{
"success": true,
"summary": {
"total": 3,
"succeeded": 2,
"failed": 1
},
"results": [
{
"success": true,
"index": 0,
"task": {
"id": "8f2c1e40-0000-0000-0000-000000000000",
"taskType": "GEMINI",
"status": "QUEUED",
"priority": 1,
"createdAt": "2026-07-09T04:12:00.000Z",
"idempotencyKey": "job-42:p1:gemini"
},
"credits": {
"creditsToCharge": 0,
"creditsCharged": 0
}
},
{
"success": false,
"index": 1,
"error": {
"code": "REGION_UNAVAILABLE",
"message": "cannot serve region 'DE': no live IPs provisioned. Check GET /capacity.",
"timestamp": "2026-07-09T04:12:00.000Z"
}
},
{
"success": true,
"index": 2,
"task": {
"id": "1b7d9c22-0000-0000-0000-000000000000",
"taskType": "GOOGLE",
"status": "QUEUED",
"priority": 1,
"createdAt": "2026-07-09T04:12:00.000Z",
"idempotencyKey": "job-42:p1:google"
},
"credits": {
"creditsToCharge": 0,
"creditsCharged": 0
}
}
]
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"details": [
{
"field": "",
"message": "Too small: expected array to have >=1 items"
}
],
"timestamp": "2026-07-09T04:12:00.000Z"
}
}{
"success": false,
"error": {
"code": "MISSING_API_KEY",
"message": "Missing or invalid API key",
"timestamp": "2026-07-09T04:12:00.000Z"
}
}{
"success": false,
"error": {
"code": "PAYLOAD_TOO_LARGE",
"message": "batch body exceeds 8388608 bytes",
"timestamp": "2026-07-09T04:12:00.000Z"
}
}Autorizaciones
Your API key, sent as Authorization: Bearer <key>.
Cuerpo
application/json
Required array length:
1 - 500 elementsThe 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.
Opciones disponibles:
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.
Rango requerido:
1 <= x <= 10Optional. Omit to collect the result by polling instead.
Show child attributes
Show child attributes