> 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/documentation/es/comenzar/inicio-rapido-web-scraper-api.md).

# Inicio rápido: Web Scraper API

{% hint style="info" %}
¿Ya estás familiarizado con lo básico? Consulta [la documentación de Web Scraper API](/products/es/web-scraper-api.md) o nuestro práctico [centro de integración](/integrations/es/integraciones-de-web-scraper-api.md).
{% endhint %}

Oxylabs [Web Scraper API](https://oxylabs.io/products/scraper-api/web) es una solución todo en uno que maneja automáticamente la rotación de proxies, el renderizado de JavaScript y los sistemas anti-bot. Esta guía te llevará de una terminal vacía a datos web en tiempo real en solo unos minutos.

Sigue los pasos detallados a continuación o mira un breve video explicativo:

{% embed url="<https://www.youtube.com/watch?t=2s&v=WOD0mZnu-j0>" %}

{% stepper %}
{% step %}

### Configuración y credenciales

Antes de enviar tu primera solicitud, necesitas autorizar tu acceso:

1. **Crear una cuenta:** Regístrate en el [panel de Oxylabs](https://dashboard.oxylabs.io/).
2. **Elige un plan:** Elige una prueba gratis para hacer pruebas o una suscripción de inmediato.
3. **Crear un usuario de API:** Ve a la sección "Web Scraper API" de la izquierda y selecciona la pestaña "Users".
4. **Guardar tus credenciales:** Estas credenciales específicas de API (no tu inicio de sesión del panel) se requieren para todas las solicitudes.
   {% endstep %}

{% step %}

### Tu primera solicitud

La `universal` fuente funciona para cualquier sitio web público. Abre tu terminal y ejecuta este comando para extraer datos de nuestro sitio sandbox:

```bash
curl --user 'USERNAME:PASSWORD' \
'https://realtime.oxylabs.io/v1/queries' \
-H 'Content-Type: application/json' \
-d '{
    "source": "universal",
    "url": "https://sandbox.oxylabs.io/products"
}'
```

{% endstep %}

{% step %}

### Obtener datos estructurados

Si estás extrayendo datos de un dominio compatible (como Amazon o Google), la API puede devolver JSON estructurado en lugar de HTML sin procesar. Solo establece la `source` en un destino dedicado y usa `"parse": true`. Por ejemplo, extraigamos un producto de Amazon:

```bash
curl 'https://realtime.oxylabs.io/v1/queries' \
--user "USERNAME:PASSWORD" \
-H "Content-Type: application/json" \
-d '{
    "source": "amazon_product", 
    "query": "B07FZ8S74R", 
    "parse": true
}'
```

{% endstep %}
{% endstepper %}

### Parámetros esenciales

Estos son los parámetros más comunes que se usan para personalizar tu solicitud:

| Parámetro       | Tipo     | Descripción                                                                                          |
| --------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| `source`        | cadena   | Requerido. El motor de scraping (p. ej., `universal`, `amazon`, `google`, etc.).                     |
| `url` / `query` | cadena   | El enlace de destino o la palabra clave/ID para destinos dedicados.                                  |
| `parse`         | booleano | Establécelo en `true` para obtener resultados JSON estructurados en dominios compatibles.            |
| `render`        | cadena   | Establécelo en `HTML` para habilitar un navegador sin interfaz para sitios web con mucho JavaScript. |
| `geo_location`  | cadena   | Localiza tus resultados (p. ej., `Estados Unidos` o `90210`).                                        |

Puedes encontrar más parámetros personalizables en la documentación de la [Web Scraper API](/products/es/web-scraper-api.md) o [sección de destinos de API.](/api-targets/es/cualquier-dominio.md) sección.

### Códigos de respuesta comunes

| Código | Estado                   | Descripción                                               |
| ------ | ------------------------ | --------------------------------------------------------- |
| `200`  | `OK`                     | Éxito. Tus datos están en el `results` objeto.            |
| `401`  | `No autorizado`          | Comprueba tus credenciales de Usuario de API en el panel. |
| `429`  | `Demasiadas solicitudes` | Has excedido tu límite de concurrencia.                   |

Puedes encontrar la [lista completa de códigos de respuesta](/products/es/web-scraper-api/response-codes.md) en la sección de productos de Web Scraper API.

### Siguientes pasos

Ahora que has enviado tu primera consulta, explora el resto de nuestra documentación según tus necesidades:

* **¿Buscas dominios específicos?** Ve a la [API Targets](https://developers.oxylabs.io/api-targets/es/) sección para guías dedicadas sobre Amazon, Google, eBay y muchos más sitios web populares.
* **¿Necesitas funciones avanzadas?** Visita el [Productos](/products/es/web-scraper-api.md) espacio para aprender sobre Custom Parsing, Scheduler, la entrega en Cloud Storage y más.
* **¿Escalar con IA?** Consulta [soluciones para flujos de trabajo de IA](/products/es/web-scraper-api/solutions-for-ai-workflows.md) o mira cómo [OxyCopilot](/products/es/web-scraper-api/web-scraper-api-playground/oxycopilot.md) puede automatizar tu lógica de análisis usando lenguaje sencillo.
* **¿Diferentes integraciones?** Usamos la integración síncrona Realtime en nuestros ejemplos. Puedes encontrar Proxy Endpoint o la integración asíncrona Push-Pull en la [página de métodos de integración](/integrations/es/integraciones-de-web-scraper-api.md) .


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/documentation/es/comenzar/inicio-rapido-web-scraper-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
