Inicio rápido de la API de datos de búsqueda con IA

Guía de inicio · Planes y créditos de la API

1. Configura tus credenciales

export BASE="https://api.querying.ai"
export API_KEY="<your-key>"

2. Envía una tarea

Hazle una pregunta a Gemini. taskType elige el motor; payload.prompt es lo que preguntas.

curl -X POST "$BASE/v1/async/task" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026", "country": "US" }
  }'

La tarea se acepta y entra en cola:

{
  "success": true,
  "task": {
    "id": "8f2c1e40-...",
    "taskType": "GEMINI",
    "status": "QUEUED",
    "priority": 1,
    "createdAt": "2026-07-09T04:12:00.000Z"
  },
  "credits": { "creditsToCharge": 0, "creditsCharged": 0 }
}

credits forma parte del sobre de respuesta. Al enviar y al sondear siempre vale cero; el webhook informa el coste en créditos de cada motor (1–2 créditos para los motores de respuesta públicos y 12 para Prompt Research; Source Influence se mide por separado). Los saldos se ven en el panel.

3. Recoge el resultado

Webhook (recomendado)
Sondeo

Añade webhook.url al enviar. Cuando la tarea llega a un estado final enviamos allí el resultado completo por POST y nunca tienes que sondear.

curl -X POST "$BASE/v1/async/task" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026" },
    "webhook": { "url": "https://your-server.example.com/hook" }
  }'

Tu endpoint recibe { task, credits, response }. Consulta Webhooks para el contrato de entrega y reintentos.

Omite webhook y consulta la tarea por id. response no aparece hasta que la tarea termina.

curl "$BASE/v1/async/task/8f2c1e40-..." \
  -H "Authorization: Bearer $API_KEY"

{
  "success": true,
  "task": { "id": "8f2c1e40-...", "status": "COMPLETED", "...": "..." },
  "credits": { "creditsToCharge": 0, "creditsCharged": 0 },
  "response": {
    "text": "The best wireless earbuds in 2026 are ...",
    "sources": [{ "position": 1, "url": "https://...", "label": "..." }]
  }
}

El sondeo público está disponible durante 24 horas tras la finalización. Sondea dentro de ese plazo o una tarea completada devolverá 404 por caducidad.

4. Envío en lote

POST /v1/async/task/batch acepta un array JSON de los mismos objetos de tarea, hasta 500 por solicitud. Puedes mezclar motores libremente en un mismo lote.

curl -X POST "$BASE/v1/async/task/batch" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    { "taskType": "GEMINI",     "payload": { "prompt": "best wireless earbuds 2026" } },
    { "taskType": "PERPLEXITY", "payload": { "prompt": "best wireless earbuds 2026" } },
    { "taskType": "GOOGLE",     "payload": { "query":  "best wireless earbuds 2026" } }
  ]'

Un lote bien formado siempre devuelve 200. Los fallos individuales aparecen como results[].success = false, así que una tarea errónea nunca arrastra al resto. Consulta Envío en lote.

Los motores de la familia Google (GOOGLE, AIMODE, NAVER_*) leen payload.query. Los motores LLM leen payload.prompt. Enviar cualquiera de los dos supera la validación, pero cada motor lee primero el que espera.

Siguientes pasos

Elige un motor

Cada taskType y lo que devuelve.

Gestiona los fallos

Códigos de error, códigos de estado y qué se puede reintentar.

Primeros pasos

Conceptos clave

Motores

Source Influence

Prompt Research

Monitorización GEO

Migración

Inicio rápido de la API de datos de búsqueda con IA

1. Configura tus credenciales

2. Envía una tarea

3. Recoge el resultado

4. Envío en lote

Siguientes pasos

Elige un motor

Gestiona los fallos

​1. Configura tus credenciales

​2. Envía una tarea

​3. Recoge el resultado

​4. Envío en lote

​Siguientes pasos

Elige un motor

Gestiona los fallos

1. Configura tus credenciales

2. Envía una tarea

3. Recoge el resultado

4. Envío en lote

Siguientes pasos