Guía rápida de la API de datos de búsqueda IA

Crea una clave, envía una pregunta y recibe la respuesta mediante sondeo o webhook.

Envías una tarea

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer vt_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026" },
    "webhook": { "url": "https://yours.app/hooks/querying" }
  }'

Tu webhook recibe

{
  "task": {
    "id": "8f2c1e40-…",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-07-17T04:12:00.000Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "The best wireless earbuds in 2026 are …",
    "sources": [
      { "position": 1,
        "url": "https://example.com/review",
        "label": "Best earbuds, reviewed" }
    ],
    "timing": { "totalMs": 7400 }
  }
}

1. Preparar la clave API

Crea una cuenta gratuita y genera una clave en el panel. Guárdala en la variable de entorno del servidor QUERYING_API_KEY y úsala desde el servidor. Las cuentas nuevas reciben 500 créditos antes de añadir un método de pago.

2. Enviar una pregunta

El comando envía una pregunta a Gemini con ES como país. El texto conserva el idioma en que lo escribes. Usa el task.id de la respuesta de aceptación en el siguiente paso.

cURL

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "mejores auriculares inalámbricos para desplazarse",
    "country": "ES"
  }
}'

3. Recoger el resultado

Sustituye TASK_ID por el ID recibido. Mientras el estado sea QUEUED o PROCESSING, consulta de nuevo tras una pausa. Con COMPLETED lee response; con FAILED procesa el error. Recoge y guarda el resultado dentro de las 24 horas posteriores a su finalización.

cURL

curl https://api.querying.ai/v1/async/task/TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

4. Recibir resultados por webhook

Añade webhook.url al JSON y prepara un receptor HTTPS con la verificación de firma documentada. Hay hasta 5 intentos: el envío inicial y 4 reintentos con espera progresiva. Deduplica las entregas usando task.id.

JSON

{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "mejores auriculares inalámbricos para desplazarse",
    "country": "ES"
  },
  "webhook": {
    "url": "https://your-server.example.com/querying-webhook"
  }
}

5. Añadir motores y mediciones periódicas

Consulta taskType, prompt o query, países admitidos y estructura de respuesta de cada motor. Resuelve los límites de saldo o concurrencia antes de reintentar. Guarda un conjunto fijo de preguntas en Monitors para seguir la visibilidad de marca.

Diseñado para estos equipos

Una fuente de datos estructurada para los equipos que analizan la búsqueda con IA.

Monitoreo GEO y AEO

Rastrea cómo las superficies de búsqueda con IA mencionan tu marca, productos y competidores, por motor, país y prompt.

Inteligencia competitiva

Observa qué marcas citan y qué productos recomiendan los motores de IA en tu mercado.

Dashboards para agencias

Monitorea decenas de clientes simultáneamente con APIs batch y webhooks, cruzando motores y regiones.

Investigación y análisis

Estudia el comportamiento de búsqueda con IA en diferentes mercados con datos estructurados para investigación, estrategia de contenido y SEO.

Todos los casos de uso →

Funciones relacionadas

Empieza con 500 créditos gratis

Ejecuta tu primera tarea en el Playground o llama a la API con tu clave.

Empieza gratis Ver precios