> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/es/web-scraper-api/objetivos/llm-e-ia.md).

# LLM e IA

Encuentra guías de scraping de Oxylabs Web Scraper API para los LLM y plataformas de IA más populares.

Los scrapers LLM de Oxylabs te permiten enviar prompts a las principales plataformas de IA y recibir respuestas estructuradas y analizadas. Destinos compatibles:

* [**ChatGPT**](/products/es/web-scraper-api/objetivos/llm-e-ia/chatgpt.md) – fuente: `chatgpt`
* [**Gemini**](/products/es/web-scraper-api/objetivos/llm-e-ia/gemini.md)– fuente: `gemini`
* [**Perplexity**](/products/es/web-scraper-api/objetivos/llm-e-ia/perplexity.md) – fuente: `perplexity`

{% hint style="success" %}
Todos los scrapers dedicados de LLM e IA admiten **instrucciones personalizadas del navegador**. [**Más información**](/products/es/web-scraper-api/features/js-rendering-and-browser-control.md#browser-instructions)**.**
{% endhint %}

### Método de integración

Las fuentes de LLM e IA usan el [**Push-Pull**](/products/es/web-scraper-api/integration-methods/push-pull.md) método de integración. En lugar de mantener la conexión abierta hasta que la respuesta esté lista, envías un trabajo y recoges el resultado una vez que termina:

1. **Enviar el trabajo:** envía tu prompt al endpoint Push-Pull. Recibes inmediatamente un ID de trabajo, no el resultado.
2. **Espera a que termine:** o bien deja que te notifiquemos con `callback_url` (recomendado), o [comprueba el estado del trabajo](/products/es/web-scraper-api/integration-methods/push-pull.md#check-job-status) tú mismo.
3. **Recupera el resultado:** una vez que el estado sea `done`, recupera la respuesta analizada.

{% hint style="info" %}
**Realtime y Proxy Endpoint no están disponibles** para `chatgpt`, `gemini`, y `perplexity` fuentes. Estos objetivos tardan más en completarse de lo que permite una conexión sincrónica, así que Push-Pull es el único método compatible.
{% endhint %}

## Ejemplo de solicitud

Todos los objetivos de LLM usan en gran medida los mismos parámetros de solicitud; la principal diferencia es la longitud máxima del prompt.

Envía la carga útil al endpoint Push-Pull - consulta las páginas individuales de cada objetivo para ver ejemplos completos de código.

```json
{
  "source": "chatgpt",
  "prompt": "mejores suplementos para dormir mejor",
  "parse": true,
  "geo_location": "Estados Unidos",
  "callback_url": "https://your-server.com/oxylabs-callback"
}
```

<table><thead><tr><th width="195.5">Parámetro</th><th width="452.5">Descripción</th><th width="117">Tipo</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>source</code></strong></mark></td><td>El objetivo de LLM a extraer. Valores permitidos: <code>chatgpt</code>, <code>perplexity</code>, <code>gemini</code>.</td><td>cadena</td></tr><tr><td><mark style="background-color:green;"><strong><code>prompt</code></strong></mark></td><td>Consulta o prompt a enviar. Longitud máxima: 4,000 caracteres para <code>chatgpt</code>; 8,000 caracteres para <code>perplexity</code> y <code>gemini</code>.</td><td>cadena</td></tr><tr><td><code>callback_url</code></td><td><strong>Recomendado.</strong> URL donde entregamos una notificación una vez que el trabajo se completa, para que no tengas que comprobar el estado tú mismo. <a href="/products/es/web-scraper-api/integration-methods/push-pull.md"><strong>Más información</strong></a>.</td><td>cadena</td></tr><tr><td><code>parse</code></td><td>Establécelo en <code>true</code> para recibir una respuesta JSON estructurada.</td><td>booleano</td></tr><tr><td><code>geo_location</code></td><td>Ubicación geográfica desde la que se enruta la solicitud (p. ej., <code>"Estados Unidos"</code>).</td><td>cadena</td></tr><tr><td><code>browser_instructions</code></td><td>Ejecuta instrucciones personalizadas opcionales del navegador al renderizar JavaScript. <a href="/products/es/web-scraper-api/features/js-rendering-and-browser-control.md#browser-instructions"><strong>Más información</strong></a>.</td><td>arreglo</td></tr></tbody></table>

\- parámetro obligatorio

{% hint style="success" %}
**Nota:** La renderización de JavaScript está habilitada de forma predeterminada para todos los objetivos de LLM. No incluyas `render` en la carga útil de tu solicitud.
{% endhint %}

## Respuesta

Todos los objetivos de LLM devuelven la misma estructura de datos de nivel superior (consulta las páginas individuales de cada objetivo para ver la referencia completa de campos de respuesta).

### Envío del trabajo

Al enviarlo se devuelven los detalles del trabajo, incluido el ID que usarás para recoger el resultado. Esto **no** contiene los datos extraídos.

<table><thead><tr><th width="196">Campo</th><th width="452">Descripción</th><th width="114">Tipo</th></tr></thead><tbody><tr><td><code>id</code></td><td>Identificador único del trabajo de extracción. Úsalo para recuperar el resultado.</td><td>cadena</td></tr><tr><td><code>status</code></td><td>Estado actual del trabajo: <code>pending</code> mientras se ejecuta, <code>done</code> cuando el resultado está listo, <code>faulted</code> si falló (recupera el resultado solo una vez que el estado sea <code>done</code>).</td><td>cadena</td></tr><tr><td><code>source</code></td><td>Enviado <code>source</code> valor.</td><td>cadena</td></tr><tr><td><code>parse</code></td><td>Enviado <code>parse</code> valor.</td><td>booleano</td></tr><tr><td><code>prompt</code></td><td>Prompt original en la solicitud.</td><td>cadena</td></tr><tr><td><code>geo_location</code></td><td>Geolocalización usada para la solicitud. Comprueba la disponibilidad del LLM antes de elegir una <code>geo_location</code>.</td><td>cadena</td></tr><tr><td><code>created_at</code></td><td>Marca de tiempo de creación del trabajo (UTC, <code>YYYY-MM-DD HH:MM:SS</code>).</td><td>cadena</td></tr><tr><td><code>updated_at</code></td><td>Marca de tiempo de actualización del trabajo.</td><td>cadena</td></tr></tbody></table>

{% hint style="warning" %}
**Comprueba la disponibilidad del LLM antes de elegir una `geo_location`**

Cada servicio de IA solo está disponible en ciertos países, y solo podemos extraerlo desde los países donde el propio servicio está disponible. Por ejemplo, Gemini no está disponible en China continental, así que una solicitud de Gemini con `"geo_location": "China"` no puede tener éxito.

Antes de enviar solicitudes, consulta la lista oficial de países compatibles del proveedor:

* **ChatGPT** – [Países compatibles con ChatGPT](https://help.openai.com/en/articles/7947663-chatgpt-supported-countries)
* **Gemini** – [Dónde puedes usar la app web de Gemini](https://support.google.com/gemini/answer/13575153)
* **Perplexity** – no se ha publicado ninguna lista oficial.
  {% endhint %}

### Recuperación de resultados

Una vez que el estado del trabajo sea `done`, recupera el resultado usando el `job.id` que recibiste. El contenido analizado específico de cada objetivo se encuentra dentro de `results[].content` (consulta las páginas individuales de cada objetivo para ver la referencia completa de campos).

<table><thead><tr><th width="196">Campo</th><th width="452">Descripción</th><th width="114">Tipo</th></tr></thead><tbody><tr><td><code>results[].job_id</code></td><td>ID del trabajo asociado con el resultado.</td><td>cadena</td></tr><tr><td><code>results[].status_code</code></td><td>Código de estado HTTP de la obtención de la página.</td><td>entero</td></tr><tr><td><code>results[].url</code></td><td>Página objetivo del LLM.</td><td>cadena</td></tr><tr><td><code>results[].content</code></td><td>Datos de respuesta del LLM. Los campos varían según el objetivo.</td><td>objeto</td></tr></tbody></table>

### Datos de respuesta por objetivo

La tabla siguiente muestra qué campos de datos están disponibles para cada objetivo de LLM.

|                                                                                 | [**ChatGPT**](/products/es/web-scraper-api/objetivos/llm-e-ia/chatgpt.md) | [**Gemini**](/products/es/web-scraper-api/objetivos/llm-e-ia/gemini.md) | [**Perplexity**](/products/es/web-scraper-api/objetivos/llm-e-ia/perplexity.md) |
| ------------------------------------------------------------------------------- | :-----------------------------------------------------------------------: | :---------------------------------------------------------------------: | :-----------------------------------------------------------------------------: |
| Entrada del prompt                                                              |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| Salida analizada (JSON)                                                         |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| Respuesta de texto plano                                                        |                                     ✓                                     |                                    ✓                                    |                                        –                                        |
| Salida Markdown                                                                 |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| Árbol JSON de Markdown                                                          |                                     ✓                                     |                                    –                                    |                                        ✓                                        |
| <mark style="background-color:yellow;">Búsqueda / consultas relacionadas</mark> |                                     –                                     |                                    –                                    |                                        ✓                                        |
| <mark style="background-color:yellow;">Citas / fuentes</mark>                   |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| <mark style="background-color:yellow;">Enviado</mark>                           |                                     ✓                                     |                                    –                                    |                                        –                                        |
| <mark style="background-color:yellow;">Anuncios</mark>                          |                                     ✓                                     |                                    –                                    |                                        –                                        |
| Geolocalización                                                                 |                                     ✓                                     |                                    ✓                                    |                                        ✓                                        |
| Modelo de LLM utilizado                                                         |                                     –                                     |                                    ✓                                    |                                        ✓                                        |

&#x20;    – condicional, se devuelve solo cuando el contenido está en la respuesta del LLM.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/es/web-scraper-api/objetivos/llm-e-ia.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.