> 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/api-web/search.md).

# /search

Aprende a usar el endpoint /search de la Oxylabs Web API para buscar en la web en vivo y recopilar resultados clasificados.

El `/v1/search` endpoint realiza búsquedas web en vivo y devuelve resultados orgánicos clasificados, incluidos títulos, fragmentos, URLs, metadatos de posición y consultas relacionadas. Funciona como una herramienta de descubrimiento para identificar páginas web autorizadas antes de pasar las URL objetivo al [`/v1/scrape`](/products/es/api-web/scrape.md) endpoint para la extracción completa de la página.

## Ejemplo de solicitud

El endpoint acepta un cuerpo de solicitud JSON con la **consulta**, **límites de resultados**, y **geolocalización** parámetros.

```bash
curl https://webapi.oxylabs.io/v1/search \

  -H "Authorization: Bearer $OXYLABS_WEB_API_KEY" \

  -H 'Content-Type: application/json' \

  -d '{
    "query": "eu ai act compliance deadlines",
    "max_results": 3,
    "location": "DE"
  }'
```

### Parámetros de la solicitud

<table><thead><tr><th width="123">Parámetro</th><th width="533">Descripción</th><th width="88">Tipo</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><code>consulta</code></mark></td><td>Palabra clave o frase de búsqueda (entre <code>1</code> y <code>2,048</code> caracteres).</td><td>cadena</td></tr><tr><td><code>max_results</code></td><td>Número de resultados orgánicos de búsqueda a devolver (entre <code>1</code> y <code>20</code>). Valor predeterminado: <code>10</code></td><td>entero</td></tr><tr><td><code>location</code></td><td>Código de país ISO 3166-1 alfa-2 (p. ej., <code>DE</code>, <code>US</code>) para búsqueda localizada.</td><td>cadena</td></tr></tbody></table>

&#x20;    – parámetro obligatorio.

{% hint style="warning" %}
Los parámetros desconocidos o mal escritos se rechazan con un HTTP `400 Bad Request` código de estado, no se ignoran.
{% endhint %}

### Optimización de solicitudes

<details>

<summary><strong><code>consulta</code></strong></summary>

Se recomienda escribir lo que una persona teclearía en un cuadro de búsqueda. Las consultas en forma de palabra clave superan a las de forma de oración:

<table><thead><tr><th width="373">En lugar de</th><th>Usa</th></tr></thead><tbody><tr><td>"¿Puedes decirme cuáles son los plazos de cumplimiento de la Ley de IA de la UE?"</td><td><code>plazos de cumplimiento de la Ley de IA de la UE</code></td></tr><tr><td>"quiero saber cuánto cuesta Figma por puesto"</td><td><code>precio de Figma por puesto</code></td></tr></tbody></table>

Una pregunta por solicitud. Una consulta compuesta devuelve resultados que no coinciden bien con ninguna de las dos mitades.

</details>

<details>

<summary><strong><code>max_results</code></strong></summary>

El parámetro es un límite, no un objetivo. Una consulta con menos coincidencias devuelve menos resultados, que se ordenan con los mejores primero.

</details>

<details>

<summary><strong><code>location</code></strong></summary>

Los precios, la disponibilidad, el idioma y los rankings suelen cambiar según el país.

El código ISO 3166-1 alfa-2 es el único formato aceptado (p. ej., `DE`, `US`). Un par bien formado que no corresponda a un país asignado se rechaza con un `400` código de error. Omitir el parámetro establece una `predeterminada` locale, que solo es óptima cuando la respuesta no depende de la ubicación.

</details>

## Ejemplo de salida

```json
{
    "state": "done",
    "results": [
        {
            Cronograma de implementación | Ley de Inteligencia Artificial de la UE
            "outline": [
                "Proveedores: Los proveedores de modelos de GPAI que se hayan introducido en el mercado antes de esta fecha deben cumplir con la AI Act antes del 2 de agosto de 2027. ... Estados miembros: Plazo para que los Estados miembros informen a la Comisión sobre el estado de los recursos financieros y humanos de las autoridades nacionales competentes ..."
            ],
            "url": "https://artificialintelligenceact.eu/implementation-timeline/",
            "metadata": {
                "position": 1
            }
        },
        {
            Cronograma de la Ley de IA de la UE: fechas y plazos clave de cumplimiento explicados
            "outline": [
                "Mientras la Comisión Europea trabaja con los Estados miembros para desarrollar la infraestructura de informes y supervisión de la AI Act hasta agosto de 2025, las empresas tienen varias áreas clave en las que centrarse: establecer un sistema de gestión de riesgos, implementar medidas de gobernanza de datos, elaborar documentación técnica ..."
            ],
            "url": "https://www.dataguard.com/eu-ai-act/timeline",
            "metadata": {
                "position": 2
            }
        },
        {
            Cronograma para la implementación de la Ley de IA de la UE | AI Act Service Desk
            "outline": [
                "La legislación de la AI Act de la UE se aplica progresivamente, con un despliegue completo de los principales hitos de aplicación previsto para el 2 de agosto de 2028."
            ],
            "url": "https://ai-act-service-desk.ec.europa.eu/en/ai-act/timeline/timeline-implementation-eu-ai-act",
            "metadata": {
                "position": 3
            }
        }
    ],
    "related_questions": [],
    "related_searches": [],
    "params": {
        "query": "eu ai act compliance deadlines",
        "location": "DE",
        "max_results": 3
    },
    "metadata": {
        "timestamp": 1791289627,
        "request_id": "1791289625962078444"
    }
}
```

{% hint style="warning" %}
**`outline`** es solo un fragmento representativo. Para obtener datos en vivo de la propia página, [haz scraping de la URL](/products/es/api-web/scrape.md).
{% endhint %}

### Diccionario de salida

<table><thead><tr><th width="244">Campo</th><th width="404.04296875">Descripción</th><th width="95.94140625">Tipo</th></tr></thead><tbody><tr><td><code>state</code></td><td><code>"done"</code> en caso de éxito. Una búsqueda que encuentra un fallo aguas arriba devuelve <code>500</code> con <code>state: "faulted"</code> (véase <a href="/products/es/api-web/resolucion-de-problemas.md">Códigos de error</a>).</td><td>cadena</td></tr><tr><td><code>results</code></td><td>Resultados orgánicos clasificados, con los mejores primero. Siempre presente, por lo que una salida vacía significa que no hubo coincidencias.</td><td>arreglo</td></tr><tr><td><code>results[].title</code></td><td>Título de la página obtenida.</td><td>cadena</td></tr><tr><td><code>results[].outline[]</code></td><td>Fragmentos de resultados de SERP. Truncados a mitad de oración.</td><td>arreglo de cadenas</td></tr><tr><td><code>results[].url</code></td><td>URL absoluta del resultado. Pásala a <a href="/products/es/api-web/scrape.md"><code>/v1/scrape</code></a>.</td><td>cadena</td></tr><tr><td><code>results[].metadata.position</code></td><td>Posición orgánica en la SERP, comenzando en <code>1</code>.</td><td>entero</td></tr><tr><td><code>related_questions</code></td><td>Objeto de pregunta de "People also ask" que contiene <code>question</code>, <code>title</code>, y <code>snippet</code> (cuando esté disponible).</td><td>arreglo</td></tr><tr><td><code>related_searches</code></td><td>Consultas de búsqueda relacionadas, cada una con <code>consulta</code>.</td><td>arreglo</td></tr><tr><td><code>params</code></td><td>Parámetros de ejecución, incluidos los valores predeterminados.</td><td>objeto</td></tr><tr><td><code>metadata.timestamp</code></td><td>Marca temporal Unix en segundos.</td><td>entero</td></tr><tr><td><code>metadata.request_id</code></td><td>Identificador de solicitud de 19 dígitos. <strong>Inclúyelo en los tickets de soporte.</strong></td><td>cadena</td></tr></tbody></table>

{% hint style="info" %}
`related_searches` es útil para expandir la consulta cuando una primera búsqueda devuelve pocos resultados. Ofrece la formulación que tiene mayor cobertura detrás.
{% endhint %}


---

# 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/api-web/search.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.