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.

¿Ya estás familiarizado con lo básico? Consulta la documentación de Web Scraper API o nuestro práctico centro de integración.

Oxylabs Web Scraper API 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:

1

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.
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.

2

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:

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

3

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:

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

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 o sección de destinos de API. 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 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 sección para guías dedicadas sobre Amazon, Google, eBay y muchos más sitios web populares.
• ¿Necesitas funciones avanzadas? Visita el Productos 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 o mira cómo OxyCopilot 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 .