Зачем использовать его как Scraping API
- Одна конечная точка для любого целевого URL
- Авторизация по API-ключу, оркестрация браузеров не требуется
- Ответ в формате HTML, который легко подключается к существующим парсерам
- Подходит для ETL, мониторинга, загрузки данных для ИИ и конвейеров обработки данных
Конечная точка
GET https://parsing.webunlocker.gologin.com/v1/scrape?url={encoded_url}
Авторизация
Передайте свой API-ключ в заголовках:Модель запроса
Быстрый старт
cURL
Python
JavaScript (fetch)
Поведение ответа
Сейчас тело ответа содержит необработанный отрендеренный HTML/текст.200-> успех, тело содержит HTML/текст страницы401/403-> неверный или отсутствующий API-ключ422-> неверный или отсутствующийurl429-> превышен лимит запросов500+-> временная ошибка на стороне сервера
Рекомендации по повторным запросам
Повторяйте запрос с экспоненциальной задержкой (exponential backoff) при:- сетевых ошибках
- кодах
408,429,500,502,503,504
Примечание об области применения
Текущая публичная конечная точка возвращает HTML. Не рассчитывайте на дополнительные серверные конечные точки (например, для скриншотов, обхода сайтов, поиска или статистики использования), если они явно не описаны в документации и не включены для вашего аккаунта.Официальный Node.js SDK
Установка:Быстрый старт с SDK
Параметры конструктора
Основные методы SDK
scrape(url)-> нормализованный объект ответаscrapeRaw(url)-> нативныйResponsebuildScrapeUrl(url)-> полный URL запроса
Производные методы SDK (на основе возвращённого HTML)
Это не отдельные серверные конечные точки: SDK получает их из HTML, который вернул API:scrapeText(url)-> обычный текстscrapeMarkdown(url)-> markdownscrapeJSON(url)-> структурированные метаданные (title,meta,links,headings)batchScrape(urls, { concurrency })-> вспомогательный метод для нескольких запросов scrape
Типизированные ошибки
WebUnlockerErrorAuthenticationErrorRateLimitErrorAPIErrorTimeoutErrorNetworkError
401/403->AuthenticationError429->RateLimitError500+->APIError- тайм-аут/прерывание запроса ->
TimeoutError - сбой fetch/сети ->
NetworkError
CLI
scrape(необработанный HTML/текст)text(производный текст)markdown(производный markdown)json(производные метаданные)
Типичные сценарии скрейпинга
- мониторинг цен и каталогов
- обогащение данных о лидах и справочниках
- конвейеры рыночной аналитики
- агрегация и индексация контента
- загрузка данных в LLM и сценарии их извлечения
Gologin Web Access CLI (единый)
Если вам нужен более мощный CLI, который объединяет Web Unlocker и Cloud Browser в одном наборе команд, используйтеgologin-web-access: