Saltar al contenido principal
Gologin Web Unlocker es una API de scraping de un solo endpoint para sitios web con mucho JavaScript. Envías una URL, recibes el HTML o el texto de la página ya renderizada y lo procesas en tu propio flujo de extracción.

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. Con format=markdown, el cuerpo es Markdown. Con format=json, el cuerpo es un objeto JSON:
Códigos de estado:
  • 200 -> éxito, el cuerpo contiene la página en el formato solicitado
  • 400 -> solicitud incorrecta, por ejemplo, falta url; cuerpo: {"success":false,"error":"Request failed"}
  • 401 -> falta el encabezado apikey; 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 normalizado
  • scrapeRaw(url) -> Response nativo
  • buildScrapeUrl(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ámetro url, 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 formato
  • scrapeMarkdown(url) -> markdown
  • scrapeJSON(url) -> metadatos estructurados (title, description, canonical, meta, headings, links)
  • batchScrape(urls, { concurrency }) -> utilidad para realizar varias llamadas de scraping

Errores tipados

  • WebUnlockerError
  • AuthenticationError
  • RateLimitError
  • APIError
  • TimeoutError
  • NetworkError
Correspondencia:
  • 401 / 403 -> AuthenticationError
  • 429 -> RateLimitError
  • 500+ 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

Comandos:
  • scrape (HTML/texto sin procesar)
  • text (texto derivado)
  • markdown (markdown derivado)
  • json (metadatos derivados)
Ejemplos:

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, usa gologin-web-access:
Consulta Gologin Web Access CLI para ver la referencia completa.

Documentación relacionada