Por qué usarlo como Scraping API
- Un único endpoint para cualquier URL de destino
- Autenticación con clave de API, sin necesidad de orquestar navegadores
- HTML por defecto, o Markdown o JSON si lo solicitas, listo para tus parsers existentes
- Encaja fácilmente en ETL, monitorización, ingesta para IA y pipelines de datos
Endpoint
GET https://parsing.webunlocker.gologin.com/v1/scrape?url={encoded_url}
Autenticación
Envía tu clave de API en los encabezados:Modelo de solicitud
Inicio rápido
cURL
Python
JavaScript (fetch)
Comportamiento de la respuesta
Por defecto, el cuerpo de la respuesta es el HTML renderizado sin procesar de la página. Conformat=markdown, el cuerpo es Markdown. Con format=json, el cuerpo es un objeto JSON:
200-> éxito, el cuerpo contiene la página en el formato solicitado400-> solicitud incorrecta, por ejemplo, faltaurl; cuerpo:{"success":false,"error":"Request failed"}401-> falta el encabezadoapikey; cuerpo:{"message":"Missing API key in request"}
Recomendaciones para reintentos
Reintenta con espera exponencial (exponential backoff) en caso de:- errores de red
408,429,500,502,503,504
SDK oficial para Node.js
Instalación:Inicio rápido con el SDK
Opciones del constructor
Métodos principales del SDK
scrape(url)-> objeto de respuesta normalizadoscrapeRaw(url)->ResponsenativobuildScrapeUrl(url)-> URL completa de la solicitud
Métodos derivados en el SDK (a partir del HTML devuelto)
Estos no son endpoints independientes del backend; el SDK los deriva del HTML que devuelve la API. El SDK envía únicamente el parámetrourl, no format, por lo que este resultado puede diferir de la respuesta propia de la API con format=markdown o format=json:
scrapeText(url)-> texto sin formatoscrapeMarkdown(url)-> markdownscrapeJSON(url)-> metadatos estructurados (title,description,canonical,meta,headings,links)batchScrape(urls, { concurrency })-> utilidad para realizar varias llamadas de scraping
Errores tipados
WebUnlockerErrorAuthenticationErrorRateLimitErrorAPIErrorTimeoutErrorNetworkError
401/403->AuthenticationError429->RateLimitError500+y otros estados que no sean 2xx (por ejemplo,400) ->APIError- tiempo de espera agotado o cancelación ->
TimeoutError - fallo de fetch o de red ->
NetworkError
CLI
scrape(HTML/texto sin procesar)text(texto derivado)markdown(markdown derivado)json(metadatos derivados)
Casos de uso típicos del scraping
- monitorización de precios y catálogos
- enriquecimiento de datos de contactos y directorios
- pipelines de inteligencia de mercado
- agregación e indexación de contenido
- flujos de ingesta y extracción para LLM
Gologin Web Access CLI (unificado)
Para una CLI más potente que combina Web Unlocker con Cloud Browser en un único conjunto de comandos, usagologin-web-access: