Skip to main content

Primeros pasos

Scraping síncrono

El endpoint scrape ejecuta una sesión de navegador y devuelve HTML renderizado en una sola solicitud — ideal para integraciones de baja latencia.

Trabajos asíncronos

Los endpoints jobs encolan tareas de scraping y permiten consultar el estado y los resultados — ideal para alto volumen o páginas lentas.

Arquitectura REST

La API de web scraping sigue los principios REST, con URLs predecibles orientadas a recursos y códigos de estado HTTP estándar para una integración fluida y manejo de errores.

Seguridad HTTPS

Todas las comunicaciones de la API están protegidas con TLS 1.2 o superior para garantizar la integridad y privacidad de los datos.

Versiones de la API

La API de web scraping mantiene compatibilidad hacia atrás mediante versionado y actualmente opera en la Versión 1.

Autenticación

Su clave API es la credencial exclusiva para acceder a la API de web scraping. Cada servicio de Cleariflow requiere una clave única. Incluya su clave en el cuerpo JSON como api_key.

URL base

Renderizado de páginas

Las páginas se renderizan en un navegador headless real. JavaScript se ejecuta completamente antes de devolver el contenido. La protección SSRF integrada bloquea solicitudes a localhost y rangos de IP privadas.

Códigos de respuesta y error

Cuando las solicitudes fallan, la API devuelve respuestas de error JSON estructuradas con códigos y descripciones específicos para una resolución eficaz de problemas.