Docs
Войти

Screenshots API

Рендеринг любого URL в PNG или JPEG. Только viewport или вся страница, десктоп или мобильное устройство, со всеми элементами управления JS-рендеринга основного API. Идеально подходит для превью, мониторинга и снимков.

Перейдите на Crawling API (или crawl_screenshot через MCP)

Тот же конвейер JS-рендеринга, параметры скриншотов добавлены на стандартный endpoint. Отдельный Screenshots API закрыт для новых регистраций с 1 ноября 2024 года - существующие интеграции продолжают работать, отключение не планируется.

Endpoint

GEThttps://api.crawlbase.com/screenshots?token=YOUR_JS_TOKEN&url=ENCODED_URL
# Requires a JavaScript token (rendering happens in headless Chrome).
# Returns the image bytes directly. Content-Type: image/png (default).

Быстрый старт

# Save the screenshot to disk
curl 'https://api.crawlbase.com/screenshots?token=YOUR_JS_TOKEN' \
  --data-urlencode 'url=https://github.com/anthropic' \
  -o screenshot.png -G
from crawlbase import ScreenshotsAPI

api = ScreenshotsAPI({'token': 'YOUR_JS_TOKEN'})
res = api.get('https://github.com/anthropic')

with open('screenshot.png', 'wb') as f:
    f.write(res['body'])
const { ScreenshotsAPI } = require('crawlbase');
const fs = require('node:fs/promises');

const api = new ScreenshotsAPI({ token: 'YOUR_JS_TOKEN' });
const res = await api.get('https://github.com/anthropic');
await fs.writeFile('screenshot.png', res.body);

Параметры

Обязательные

token
строкаобязательный
Ваш приватный Crawlbase token.
url
строкаобязательный
URL целевой страницы. Должен начинаться с http или https и быть полностью URL-кодированным.

Специфичные для скриншотов

mode
viewport | fullpageviewport
Захватить только видимую область или всю прокручиваемую страницу.
format
png | jpegpng
PNG — для чёткого текста и UI; JPEG — для меньшего размера на страницах с большим количеством фотографий.
width
целое (px)1280
Ширина viewport.
height
целое (px)800
Высота viewport. Игнорируется при mode=fullpage.
device
desktop | mobiledesktop
Использовать предустановленный профиль устройства. Мобильные пресеты принудительно устанавливают width=375, height=812 и телефонный User-Agent.
store
булевоfalse
Сохранять скриншот в Cloud Storage. Когда значение true, ответ содержит заголовок screenshot_url, указывающий на сохранённую копию - полезно, когда нужен стабильный URL для встраивания в дашборды или передачи в смежные системы.

Управление рендерингом

Унаследовано из набора параметров Crawling API. Параметры рендеринга, которые клиенты чаще всего используют со скриншотами:

user_agent
строкаопциональный
Пользовательский User-Agent передаётся целевому сайту дословно. Закодируйте его в URL. Если не указан, Crawlbase ротирует реалистичный UA для каждого запроса.
css_click_selector
строкаопциональный
CSS-селектор элемента, по которому нужно кликнуть перед захватом скриншота (#some-button, .some-other-button). Закодируйте значение в URL.
scroll
булевоfalse
Автоматическая прокрутка страницы перед захватом. По умолчанию прокрутка длится 10 секунд. Сочетайте с scroll_interval (10–60 с), чтобы продлить её. Полезно для контента с ленивой загрузкой выше первого экрана при mode=fullpage.
page_wait
целое (ms)опциональный
Ждать указанное количество миллисекунд после загрузки страницы перед захватом - даёт время анимациям или тяжёлому JS-рендерингу завершиться.
ajax_wait
булевоfalse
Дождаться завершения активных AJAX-запросов перед захватом.
country
ISO 3166опциональный
Геолокация скриншота из конкретной страны (например, US, GB, DE). Доступность стран зависит от тарифного плана; полный список стран находится в справочнике параметров Crawling API.

Распространённые сценарии

Полностраничный мобильный скриншот

curl 'https://api.crawlbase.com/screenshots?token=YOUR_JS_TOKEN' \
  --data-urlencode 'url=https://news.ycombinator.com' \
  --data-urlencode 'mode=fullpage' \
  --data-urlencode 'device=mobile' \
  --data-urlencode 'format=jpeg' \
  -o hn-mobile.jpg -G

Скриншот после клика

# Open a "Show details" panel before capturing
curl 'https://api.crawlbase.com/screenshots?token=YOUR_JS_TOKEN' \
  --data-urlencode 'url=https://example.com/product/123' \
  --data-urlencode 'css_click_selector=button.show-details' \
  --data-urlencode 'page_wait=1500' \
  -o detail.png -G

Распространённые сценарии использования

  • Превью ссылок: генерация Open Graph-заглушек для сайтов без корректных мета-тегов.
  • Визуальный мониторинг: еженедельный захват сайта для обнаружения регрессий вёрстки.
  • Архивы для compliance: в связке с Cloud Storage для архивации того, как страница выглядела на конкретную дату.
  • Email-отчёты: встраивание актуальных скриншотов в регулярные отчёты.