> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API de datos de respuestas y citas de búsqueda con IA

> Infraestructura de datos para observar las superficies de búsqueda con IA para consumidores: ChatGPT, Perplexity, Gemini, Google AI Overview y más.

querying.ai es una API que responde a una pregunta: **¿qué dice un motor de IA cuando le preguntas algo?**
Envías un prompt dirigido a un motor y te devolvemos la respuesta de ese motor junto con las fuentes que citó.

Implementa el contrato estándar de tareas asíncronas de las API de motores de respuesta, así que un cliente
existente suele migrar cambiando solo la URL base y la clave de API, sin tocar código. Consulta
[Migrar una integración existente](/es/migrating).

## Cómo funciona

Todas las solicitudes son **asíncronas**. Envías una tarea, la ponemos en cola, un worker consulta el motor de
destino y extrae el resultado, que te llega por webhook o mediante sondeo.

<Steps>
  <Step title="Envía una tarea">
    `POST /v1/async/task` con un `taskType` y un `payload`. Recibes al instante un `id` de tarea con estado `QUEUED`.
  </Step>

  <Step title="Consultamos el motor">
    Un worker toma la tarea, consulta el motor y extrae el texto de la respuesta, las fuentes y los datos extra
    propios de cada motor.
  </Step>

  <Step title="Recoge el resultado">
    Si indicaste `webhook.url`, enviamos el resultado por POST a esa URL. Si no, consulta
    `GET /v1/async/task/{id}` hasta que `status` sea `COMPLETED` o `FAILED`.
  </Step>
</Steps>

## Qué recibes

Sea cual sea el motor, el núcleo útil de cada resultado tiene la misma forma:

<ResponseField name="text" type="string">
  La respuesta del motor en texto plano.
</ResponseField>

<ResponseField name="sources" type="array">
  Las citas que el motor adjuntó a su respuesta: `position`, `url` y normalmente `label`.
</ResponseField>

Cada motor añade sus propios campos: Google devuelve un sobre SERP completo; ChatGPT y Perplexity pueden devolver
las consultas de búsqueda que lanzaron; la pestaña de IA de Naver devuelve el panel de compras que mostró.
Consulta [Motores](/es/engines/overview) para la forma de cada uno.

## URL base

```
https://api.querying.ai
```

Todos los endpoints excepto `/health` y `/ready` requieren un [token bearer](/es/authentication).

<Card title="Empieza aquí" icon="rocket" href="/es/quickstart">
  Envía tu primera tarea y recibe un resultado en menos de cinco minutos.
</Card>

## Explora los productos

* [Recopilación de respuestas de IA](https://querying.ai/es/answers)
* [Análisis de evidencia de fuentes](https://querying.ai/es/source-influence)
* [Monitorización GEO](https://querying.ai/es/monitors)
* [Guía de inicio de la API](https://querying.ai/es/guides/quickstart)
