# Inicio rápido: Web Scraper API

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 antibot. Esta guía te llevará de un terminal vacío a datos web en tiempo real en solo unos minutos.

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

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

{% stepper %}
{% step %}

### Configuración y credenciales

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

1. **Crea una cuenta:** Regístrate en el [Oxylabs Dashboard](https://dashboard.oxylabs.io/).
2. **Elige un plan:** Elige una prueba gratuita para probar o una suscripción de inmediato.
3. **Crea un usuario de API:** Ve a la sección "Web Scraper API" a la izquierda y selecciona la pestaña "Users".
4. **Guarda tus credenciales:** Estas credenciales específicas de API (no tu inicio de sesión del panel) son necesarias 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 %}

### Obtención de 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 usados para personalizar tu solicitud:

| Parámetro       | Tipo    | Descripción                                                                                   |
| --------------- | ------- | --------------------------------------------------------------------------------------------- |
| `source`        | string  | Obligatorio. El motor de scraping (por ejemplo, `universal`, `amazon`, `Google Search` etc.). |
| `url` / `query` | string  | El enlace de destino o la palabra clave/ID para destinos dedicados.                           |
| `parse`         | boolean | Establécelo en `true` para obtener resultados JSON estructurados en dominios compatibles.     |
| `render`        | string  | Establécelo en `html` para habilitar un Headless Browser para sitios con mucho JavaScript.    |
| `geo_location`  | string  | Localiza tus resultados (por ejemplo, `United States` o `90210`).                             |

### Códigos de respuesta comunes

| Código | Estado              | Descripción                                               |
| ------ | ------------------- | --------------------------------------------------------- |
| `200`  | `OK`                | Correcto. Tus datos están en el objeto `results` .        |
| `401`  | `Unauthorized`      | Revisa las credenciales de tu usuario de API en el panel. |
| `429`  | `Too Many Requests` | Has superado tu límite de concurrencia.                   |

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

### Próximos 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 sección [API Targets](https://developers.oxylabs.io/api-targets/) para guías dedicadas de Amazon, Google, eBay y muchos otros sitios web populares.
* **¿Necesitas funciones avanzadas?** Visita el espacio [Products](/products/web-scraper-api.md) para aprender sobre Custom Parsing, Scheduler, entrega a Cloud Storage y más.
* **¿Escalar con IA?** Consulta [soluciones para flujos de trabajo de IA](/products/web-scraper-api/solutions-for-ai-workflows.md) o mira cómo [OxyCopilot](/products/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 [métodos de integración](/integrations/web-scraper-api-integrations.md) página.


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.