> 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/quick-start-web-scraper-api.md).

# Inicio rápido: Web Scraper API

Empieza a usar Web Scraper API de Oxylabs en solo unos minutos con una sencilla guía paso a paso.

{% hint style="success" %}
¿Ya conoces los conceptos básicos? Consulta [la documentación de Web Scraper API](/products/es/web-scraper-api.md) o nuestro útil [centro de integración](/integrations/es/web-scraper-api-integrations.md).
{% endhint %}

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

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

{% 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 [panel de Oxylabs](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" de la izquierda y selecciona la pestaña "Usuarios".
4. **Guarda tus credenciales:** Estas credenciales específicas de API (no tus datos de acceso al panel) son necesarias para todas las solicitudes.
   {% endstep %}

{% step %}

### Tu primera solicitud

El `universal` source funciona para cualquier sitio web público. Abre tu terminal y ejecuta este comando para extraer datos de nuestro sitio de pruebas:

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

{% endstep %}

{% step %}

### Obteniendo 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 el `source` en un objetivo dedicado y usa `"parse": true`. Por ejemplo, extrayamos 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 objetivos dedicados.                     |
| `parse`         | booleano | Establécelo en `true` para resultados JSON estructurados en dominios compatibles.        |
| `render`        | cadena   | Establécelo en `html` para habilitar un Headless Browser en sitios con mucho JavaScript. |
| `geo_location`  | cadena   | Localiza tus resultados (p. ej., `Estados Unidos` o `90210`).                            |

Puedes encontrar más parámetros personalizables en la Web Scraper API [documentación](/products/es/web-scraper-api.md) o [objetivos de la API](https://developers.oxylabs.io/api-targets/es/) 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`          | Verifica las credenciales de tu usuario de API en el panel. |
| `429`  | `Demasiadas solicitudes` | Has superado 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 del producto 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 inglés sencillo.
* **¿Otras integraciones?** Usamos integración Realtime síncrona en nuestros ejemplos. Puedes encontrar Proxy Endpoint o integración Push-Pull asíncrona en la [métodos de integración](/integrations/es/web-scraper-api-integrations.md) página.


---

# 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/quick-start-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.