API скриншотов

API скриншотов сайта для разработчиков.

Отправьте публичный адрес, HTML или Markdown. Задайте экран, уберите лишнее и получите PNG, JPG, WebP, PDF, HTML или Markdown.

Site2image снимает публичную страницу в файл. Отправьте адрес, HTML или Markdown. По умолчанию это PNG всей страницы. Можно убрать cookie-баннеры, рекламу и чаты, выбрать телефон или CSS-селектор и забрать файл по подписанной ссылке, вебхуком или через тег изображения.

  • PNG
  • JPG
  • WebP
  • PDF
  • HTML
  • Markdown

Токен API будет на следующем экране.

  • Вся страница, экран или элемент
  • Баннеры, реклама и чаты блокируются
  • Подписанные ссылки и вебхуки
  • Один вызов или пакет, JSON или CSV
  • Встройте изображение на страницу
https://example.com
PNG

Снятая страница

Example Domain

Вся страница, а не только первый экран.

POST /api/v1/screenshots
Authorization: Bearer <access_token>

{
  "url": "https://example.com",
  "full_page": true
}

202 Accepted  status: pending

Что меняет один запрос

Источник, экран, лишнее, ожидание и файл, который вернётся.

Блокировка

Чистые скриншоты

Скажите, что должно остаться за кадром. Тот же запрос скрывает баннеры, рекламу и виджеты.

Баннеры cookie, реклама и чаты

Блокируйте баннеры cookie, баннеры по эвристике, рекламу, трекеры и виджеты чатов.

Скрывайте селекторы

Передайте CSS-селекторы, которые нужно скрыть. Остальная страница остаётся на снимке.

Блокируйте запросы и ресурсы

Блокируйте шаблоны URL или отбрасывайте типы ресурсов: image, stylesheet, script, font, media и XHR.

POST /api/v1/screenshots Пример
{
  "url": "https://example.com",
  "block_cookie_banners": true,
  "block_banners_by_heuristics": true,
  "block_ads": true,
  "block_trackers": true,
  "block_chats": true,
  "hide_selectors": [ ".cookie", ".chat" ],
  "block_resources": [ "font" ]
}

Рендер

Страница рендерится так, как нужно снимку

Тема, движение, скрипты и паузы — поля того же запроса.

Тема, движение и носитель

Запросите тёмную или светлую тему, уменьшенное движение или замороженные анимации. Эмулируйте screen или print.

CSS и JavaScript

Вставьте стили и выполните скрипт до снимка. Если скрипт переходит на другую страницу, назовите событие, которого нужно дождаться. Обходите Content-Security-Policy, когда страница блокирует эту вставку.

Ожидание, клик и наведение

Дождитесь load, DOMContentLoaded или затишья сети. Дождитесь селектора, кликните его, наведите курсор или прокрутите в зону видимости, затем добавьте паузу. Задайте, сколько могут длиться переход и ожидание селектора.

POST /api/v1/screenshots Пример
{
  "url": "https://example.com",
  "dark_mode": true,
  "reduce_motion": true,
  "media_type": "screen",
  "styles": "header { position: static }",
  "wait_until": [ "networkidle0" ],
  "wait_for_selector": ".price",
  "click": "button.accept",
  "delay": 0.5
}

Окно

Любой экран, вся страница или один элемент

Начните с телефона или планшета либо задайте окно сами. Снимите всё, один экран, селектор или прямоугольник.

Пресеты устройств

Пресеты iPhone, Pixel, Galaxy и iPad задают размер, плотность пикселей, касание, альбомную ориентацию и user agent. Эти поля можно задать и самим. GET /api/v1/devices перечисляет идентификаторы.

Вся страница, вместе с ленивым содержимым

Полная страница включена по умолчанию. Прокрутите страницу, чтобы подгрузить ленивое содержимое, ограничьте высоту или сохраните перекрывающиеся вертикальные срезы PNG, JPG или WebP.

Селектор или фрагмент

Снимите CSS-селектор, в том числе как прямоугольник, или передайте clip_x, clip_y, clip_width и clip_height. Задача завершается ошибкой, если селектор, клик или наведение ничего не находят.

POST /api/v1/screenshots Пример
{
  "url": "https://example.com",
  "viewport_device": "iphone_14",
  "full_page": true,
  "full_page_scroll": true,
  "full_page_max_height": 8000,
  "selector": "article"
}

Вход и выход

На входе URL, HTML или Markdown

Отправьте ровно один источник. Выберите файл, который вернётся.

URL, HTML или Markdown

Публичный адрес http или https, HTML до 500 КБ или Markdown до 200 КБ.

Шесть форматов

PNG, JPG, WebP, PDF, HTML или Markdown. JPEG сохраняется как JPG. MARKDOWN сохраняется как MD.

Параметры изображения и PDF

Измените размер изображения, задайте качество JPEG или WebP от 0 до 100 или уберите фон для прозрачного PNG. Для PDF задайте бумагу, поля, альбомную ориентацию, укладку на одну страницу и печать фона.

POST /api/v1/screenshots Пример
{
  "markdown": "# Receipt\n\nThanks for your order.",
  "format": "PDF",
  "pdf_paper_format": "a4",
  "pdf_margin": "12mm",
  "pdf_print_background": true
}

Метаданные

Что было на странице

Запросите факты в готовой задаче или завершите снимок ошибкой, если текст не тот.

Факты о странице

Размер изображения, заголовок, статус HTTP, шрифты, теги Open Graph и значок страницы.

Содержимое страницы

Включите содержимое как HTML, простой текст или Markdown.

Проверки текста

Завершайте ошибкой, если текст страницы содержит строку или в нём нет обязательной строки. Сохраните свой внешний идентификатор и ключ кэша в задаче.

POST /api/v1/screenshots Пример
{
  "url": "https://example.com",
  "metadata_page_title": true,
  "metadata_open_graph": true,
  "metadata_content": true,
  "metadata_content_format": "markdown",
  "fail_if_content_missing": [ "In stock" ]
}

Запрос

Отправьте запрос, которого ждёт страница

Заголовки, cookie, место и время уходят вместе со снимком. Частные сети отклоняются.

Заголовки, cookie и auth

Добавьте заголовки запроса, значение Authorization для страницы и cookie, которые остаются на целевом хосте.

Часовой пояс и геолокация

Задайте часовой пояс IANA, широту, долготу и точность. Задайте user agent сами или позвольте это пресету устройства.

Закрытые хосты не открываются

Localhost, имена .local и частные, loopback и link-local адреса отклоняются до того, как их откроет Chrome. ignore_host_errors продолжает работу, когда сама публичная страница возвращает ошибку HTTP.

POST /api/v1/screenshots Пример
{
  "url": "https://example.com",
  "time_zone": "Europe/Berlin",
  "geolocation_latitude": 52.52,
  "geolocation_longitude": 13.405,
  "authorization": "Bearer page-token",
  "headers": { "Accept-Language": "en" },
  "cookies": [ "session=abc; Domain=example.com; Secure" ]
}

Три шага до снимка

Создайте аккаунт, отправьте источник и заберите файл, когда он будет готов.

1

Создайте аккаунт

Вы получите токен доступа. API принимает его в заголовке Authorization.

2

Отправьте источник

Публичный адрес, HTML или Markdown. Site2image проверяет адрес, принимает задачу и отвечает 202, пока идёт снимок.

3

Заберите файл

Опросите скриншот или передайте callback URL, и мы отправим подписанную ссылку методом POST.

Доставка

Сначала задача, потом подписанный файл

Create отвечает, как только задача попадает в очередь. Файл остаётся закрытым, пока не выдана подписанная ссылка.

Встроить в тег изображения

GET /api/v1/screenshots/embed снимает страницу и возвращает файл. Поместите этот URL в тег img, а access_token — в строку запроса. Кэш остаётся включённым 4 часа, если не передать cache=false.

Опрос или скачивание

Статус идёт от pending к processing, затем к ready или failed. У готовой задачи есть подписанный URL. Скачивание перенаправляет на него.

Вебхуки

Задайте callback_url, и Site2image отправит результат методом POST. Подпишите тело как HMAC-SHA256 вашего токена доступа. Сбой вебхука оставляет скриншот готовым.

Кэш

Повторно используйте последний готовый снимок с тем же адресом, форматом и параметрами. Окно по умолчанию — 4 часа. Попадание возвращает 200 с готовым скриншотом.

POST /api/v1/screenshots Пример
{
  "url": "https://example.com",
  "cache": true,
  "cache_ttl": 14400,
  "callback_url": "https://client.example.com/hooks/screenshots",
  "webhook_sign": true
}

Пакет

Создавайте снимки пакетом

Отправьте много страниц одним вызовом. Тело — массив JSON или CSV. Каждый элемент использует те же поля, что и одиночное создание.

Массив JSON

POST /api/v1/screenshots/bulk принимает до 50 объектов. Обязателен только url. Новая работа возвращает 202. Когда каждый элемент уже в кэше, ответ — 200. Неверный элемент ничего не создаёт.

Тот же пакет как CSV

Отправьте Content-Type: text/csv. Первая строка — заголовок, url обязателен. Остальные столбцы совпадают с полями JSON, включая file_type, width, height, fresh и callback_url. Заголовок ответа — id,url.

Прочитать один снимок как JSON или CSV

GET /api/v1/screenshots/:id возвращает JSON. Запросите тот же id как .csv, и те же поля придут одной строкой. Пустое значение — пустая ячейка.

POST /api/v1/screenshots/bulk Пример
[
  {
    "url": "https://example.com",
    "file_type": "png",
    "width": 1440,
    "height": 900
  },
  {
    "url": "https://example.com/pricing",
    "format": "jpg",
    "fresh": false
  }
]

Встроить

Покажите снимок в теге изображения

Адрес для встраивания снимает страницу и возвращает файл. Поместите его в тег img.

Адрес, который загружает тег

GET /api/v1/screenshots/embed принимает те же поля, что и создание. format по умолчанию PNG и также принимает JPG, WEBP и PDF. Закодируйте адрес страницы. Передайте access_token в строке запроса, потому что тег изображения не может задать заголовок.

Готовый файл по id

GET /api/v1/screenshots/:id/embed перенаправляет на сохранённые PNG, JPG или WEBP, и тег загружает этот файл. PDF, HTML и Markdown возвращают 404.

Кэш для тега

Кэш остаётся включённым 4 часа, если не передать cache=false. Токен виден в исходнике страницы, поэтому любой, кто видит тег, может создавать снимки этого аккаунта.

GET /api/v1/screenshots/embed Пример
<img
  src="/api/v1/screenshots/embed?url=https%3A%2F%2Fexample.com&access_token=<access_token>&format=jpg"
  alt="example.com">

Создайте аккаунт и отправьте первый адрес.

Токен доступа будет на следующем экране. Отправьте публичный адрес, HTML или Markdown.

MCP

Тот же захват из ассистента

Укажите MCP-клиенту адрес /mcp и передайте тот же токен. Ассистент сможет выбрать устройство, запустить съёмку и прочитать файл.

Те же инструменты

list_devices, create_screenshot, create_screenshots и get_screenshot принимают те же поля, что и HTTP API.

Тот же токен

Передавайте токен доступа в заголовке bearer. Токен остаётся в этом заголовке.

Дождитесь файла

create_screenshot ждёт файл и возвращает тот же JSON, что и проверка статуса. Небольшое изображение прилагается, чтобы ассистент его увидел. HTML и Markdown возвращаются текстом, когда размер это позволяет.

POST /mcpJSON-RPC
{
  "mcpServers": {
    "site2image": {
      "url": "https://site2image.ru/mcp",
      "headers": {
        "Authorization": "Bearer <access_token>"
      }
    }
  }
}

Прежде чем отправить первый адрес

Публичные страницы входят. Частные сети остаются закрытыми. Файл остаётся в вашем аккаунте.

Какие адреса можно снимать?

Абсолютные HTTP- и HTTPS-адреса в публичном интернете. Localhost, имена .local и частные, loopback и link-local адреса отклоняются.

Можно ли отрендерить HTML или Markdown, который у меня уже есть?

Отправьте ровно одно из полей url, html или markdown. HTML ограничен 500 КБ, Markdown — 200 КБ. Файл может быть PNG, JPG, WebP, PDF, HTML или Markdown.

Можно ли убрать баннеры и рекламу?

Блокируйте баннеры cookie, эвристические баннеры, рекламу, трекеры и чаты. Скрывайте CSS-селекторы, блокируйте шаблоны URL или отбрасывайте типы ресурсов, например script и image.

Когда я получу файл?

Создание возвращает 202 с id и статусом pending. Опросите этот скриншот или задайте callback_url, и Site2image отправит подписанную ссылку, когда снимок будет готов.

Можно ли поместить снимок в тег изображения?

Да. Используйте GET /api/v1/screenshots/embed с адресом страницы и вашим access_token в параметрах запроса. Закодируйте адрес страницы. Ответ — само изображение. Тот же адрес, формат и параметры используются снова 4 часа, если не передать cache=false. Любой, кто видит тег, может создавать снимки этого аккаунта. Готовые PNG, JPG или WebP можно также загрузить через GET /api/v1/screenshots/:id/embed.

Можно ли создать много снимков за один раз?

Да. Отправьте массив JSON методом POST на /api/v1/screenshots/bulk или те же строки как CSV с Content-Type: text/csv. Один вызов принимает до 50 элементов. Каждый элемент использует те же поля, что и одиночное создание. Новый пакет возвращает 202. Когда каждый элемент в кэше, ответ — 200.

Можно ли использовать JSON или CSV?

Одиночное создание — это JSON. Пакетное создание принимает массив JSON или CSV и отвечает в том же формате. Чтение одного снимка — JSON или CSV по адресу /api/v1/screenshots/:id.csv. Адрес для встраивания возвращает файл изображения или PDF.

Та же страница будет снята снова?

Установите cache в true, и Site2image повторно использует ваш последний готовый снимок с тем же адресом, форматом и параметрами за последние cache_ttl секунд. По умолчанию это 4 часа. Попадание возвращает 200 со ссылкой на файл.

Кто может его скачать?

Только аккаунт, который создал скриншот. Чужой id возвращает 404. Сам файл закрыт, пока не выдана подписанная ссылка.

Что, если страницу нельзя снять?

Задача помечается как неудачная, и API возвращает безопасное сообщение. Внутренние ошибки остаются на сервере. Задачу также можно завершить ошибкой, если нет обязательного текста или есть запрещённый.

Может ли ассистент вызвать это?

Да. Отправьте JSON-RPC методом POST на /mcp с тем же bearer-токеном. create_screenshot принимает те же поля, что и HTTP API, и может дождаться файла. create_screenshots отправляет до 50 снимков за один вызов.

Создайте аккаунт и вызовите API из ассистента.

Скопируйте токен и укажите MCP-клиенту адрес /mcp. Инструменты совпадают с HTTP API.

Статьи по API скриншотов

Статьи по полям API съёмки: от полной страницы и пресета телефона до подписанного вебхука.

Альтернативы другим API скриншотов

Уже вызываете другой API скриншотов? В каждой статье сказано, когда Site2image его заменяет и когда не заменяет.

Сначала аккаунт, потом тариф.

Все тарифы снимают одни и те же страницы. Токен выдаётся вместе с аккаунтом.

Тарифы

Все тарифы снимают одни и те же страницы. Меняется только лимит.

Essential

19 ₽ в месяц

228 ₽ / год

Базовый набор, чтобы начать снимать страницы сегодня.

  • 2 000 снимков в месяц
  • 30 запросов в минуту
  • Блокировка рекламы, cookie-баннеров, трекеров и чатов
  • PNG, JPG, WebP, PDF, HTML и Markdown
  • Вся страница, окно или один элемент
  • Съёмка публичного URL, HTML или Markdown
  • Повторное использование недавнего снимка
  • MCP для ассистентов, включая пакеты
  • Вебхуки, когда снимок готов
  • Подписанные ссылки на закрытый файл
  • Метаданные страницы и проверки текста
Начать с Essential

Growth

69 ₽ в месяц

828 ₽ / год

Запас для занятого продукта и более высокий темп съёмки.

  • 40 000 снимков в месяц
  • 100 запросов в минуту
  • Блокировка рекламы, cookie-баннеров, трекеров и чатов
  • PNG, JPG, WebP, PDF, HTML и Markdown
  • Вся страница, окно или один элемент
  • Съёмка публичного URL, HTML или Markdown
  • Повторное использование недавнего снимка
  • MCP для ассистентов, включая пакеты
  • Вебхуки, когда снимок готов
  • Подписанные ссылки на закрытый файл
  • Метаданные страницы и проверки текста
Начать с Growth

Создайте аккаунт, получите токен API и выберите тариф.

Найдите задачу скриншота

Это запросы, на которые отвечает этот API. Каждая ссылка открывает поля запроса для этой задачи.