Перейти к основному содержанию

Обзор

REST API Web2MD позволяет программно преобразовывать любую веб-страницу или необработанный HTML в чистый Markdown. Используйте его для построения пайплайнов, автоматизации сбора контента или интеграции Web2MD в собственные инструменты.
Для использования REST API требуется тариф PRO. Создайте API-ключ в панели управления Web2MD.

Машиночитаемые спецификации

Используйте спецификацию OpenAPI для автоматической генерации клиентских SDK или импорта в такие инструменты, как Postman, Swagger UI или фреймворки AI-агентов.

Аутентификация

Каждый запрос должен содержать ваш API-ключ в заголовке Authorization:
API-ключи начинаются с префикса w2m_ и привязаны к вашему аккаунту.

Эндпоинт

POST https://web2md.org/api/v1/convert

Тело запроса

Указывайте либо url, либо html, но не оба одновременно. Запрос завершится ошибкой 400, если указаны оба поля или ни одно из них.

Параметры

Ответ

Успешный ответ возвращает:

Лимиты запросов

Запросы к API ограничены 60 запросами в минуту на один API-ключ. При превышении лимита API возвращает код состояния 429. Дождитесь окна сброса лимита перед повторной попыткой.

Ответы с ошибками

Все ответы с ошибками имеют следующую структуру:

Примеры

Преобразование URL с помощью curl

Преобразование необработанного HTML с помощью curl

JavaScript (fetch)

Храните API-ключ в переменной окружения, а не в коде напрямую. Например, используйте process.env.WEB2MD_API_KEY в Node.js.