Inicio rápido: Web Scraper API

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

1

Configuración y credenciales

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

1. Crea una cuenta: Regístrate en el Oxylabs Dashboard.

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.

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

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:

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 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 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 para guías dedicadas de Amazon, Google, eBay y muchos otros sitios web populares.

• ¿Necesitas funciones avanzadas? Visita el espacio Products para aprender sobre Custom Parsing, Scheduler, entrega a 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 métodos de integración página.