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

# Inicio rápido: Web Scraper API

{% 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 práctico [Integration hub](/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 gestiona 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 una breve explicación en video:

{% 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" de la izquierda y selecciona la pestaña "Usuarios".
4. **Guarda tus credenciales:** Estas credenciales específicas de la API (no tu inicio de sesión del dashboard) se requieren para todas las solicitudes.
   {% endstep %}

{% step %}

### Tu primera solicitud

La `universal` source 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 define el `source` a un destino dedicado y usa `"parse": true`. Por ejemplo, vamos a extraer datos de 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   | Obligatorio. El motor de extracción (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 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 Web Scraper API [documentación](/products/es/web-scraper-api.md) o [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`          | Revisa tus credenciales de usuario de API en el dashboard. |
| `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 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 Análisis personalizado, Scheduler, 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 extracción usando lenguaje natural.
* **¿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/empezar/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.