API позволяет автоматически выпускать erid-токены для рекламы в MAX, регистрировать публикации и сдавать отчёты в ЕРИР (включая корректировки уже сданных отчётов) из вашего кода — без личного кабинета.
Все запросы идут на единый адрес:
https://htmlweb.ru/api.php?api_key=ВАШ_API_KEY&obj=ord_vk&m=МЕТОД&параметры
Параметры можно передавать как GET, так и POST запросом, можно комбинировать. Рекомендуем POST —
он не сохраняется в кеше браузера и в логах прокси-серверов. Поддерживается и JSON-тело запроса
(Content-Type: application/json — тогда api_key, obj, m
и параметры передаются в JSON).
api_key — ключ из вашего профиля htmlweb.ru: htmlweb.ru/user/api.php (32 символа). Ключ даёт полный доступ к данным вашего аккаунта — не публикуйте его в открытом коде. Через API видны и доступны только ваши макеты, публикации и отчёты.
Не требуется автоматизация? Простой выпуск erid — на странице «erid за 20 ₽».
Формат ответа — добавьте параметр &json для машинного JSON; без него ответ приходит читаемой HTML-таблицей (удобно смотреть в браузере).
При успехе {"status":200, ...}, при ошибке {"status":400, "error":"текст"}.
Коды: 400 — ошибка в данных, 403 — нет доступа (неверный api_key), 404 — не найдено, 429 — превышен лимит попыток входа.
Перед выпуском токенов проверьте, что маркировка доступна и на балансе достаточно средств:
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=status
Ответ:
{"status":200,"ready":true,"balance_ord_vk":2990,"price_token":20,
"gate":null,"mode":"our"}
ready=true — можно выпускать erid. price_token — стоимость выпуска одного
токена в рублях (списывается с баланса htmlweb или привязанной карты). gate не пустой —
маркировка временно заблокирована, в gate.reason причина (например low_balance —
пополните баланс платформы, пополнение: кабинет).
Самореклама — вы рекламируете собственный ресурс в собственном канале: и рекламодатель, и рекламораспространитель — вы сами. Договор с самим собой не заключается, отчёт сдаётся как обычно.
Шаг 1. Выпустите erid-токен методом creative, указав свой ИНН в
advertiser_inn:
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=creative
&text=Продажа автомобиля Lada Vesta, 2022 года
&advertiser_inn=ВАШ_ИНН
&urls=https://max.ru/id123456_biz
В ответе придёт {"status":200,"creative_id":123,"erid":"Xk2…","publications":[]} —
erid выпущен, с баланса списана стоимость токена (20 ₽). Токен ещё ни к чему не привязан — публикуйте пост.
Шаг 2. После публикации добавьте карточку публикации методом pub, указав
свой же ИНН как рекламораспространителя (совпадение ИНН = самореклама, договор не создаётся):
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=pub
&creative_id=123
&inn=ВАШ_ИНН
&url=https://max.ru/id123456_biz4/AaEAqhyNXl8
&date_start=2026-10-04&date_end=2026-10-04
&pay_type=cpm&shows=172&amount=500
Отчёт автоматически уйдёт в ЕРИР на следующий день после date_end. Если точное число
показов на момент публикации неизвестно — поставьте приблизительное и скорректируйте отчёт позже
(см. «Как исправить уже сданный отчёт»).
Если пост выходит в канале, который вам не принадлежит, — между вами и владельцем канала возникают отношения «рекламодатель ↔ рекламораспространитель», и по закону нужен договор. Платформа делает это автоматически:
Шаг 1. Узнайте ИНН владельца канала (рекламораспространителя) — запросите у владельца.
Проверить корректность ИНН можно методом inncheck (см. ниже): он вернёт наименование
организации/ИП из реестра — вы убедитесь, что ИНН принадлежит именно контрагенту.
Шаг 2. Выпустите erid, указав ИНН рекламодателя (ваш — если рекламируете свой товар):
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=creative
&text=Скидка 20% на весь месяц в фитнес-клубе
&advertiser_inn=614704334828
&urls=https://your-site.ru
Шаг 3. Добавьте публикацию с ИНН владельца канала в параметре inn.
ИНН разные — платформа автоматически зарегистрирует договор «рекламодатель ↔ рекламораспространитель»
в ЕРИР и привяжет к нему отчёт:
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=pub
&creative_id=123
&inn=615016514444
&url=https://max.ru/id615016514444_biz4/AaEAqhyNXl8
&date_start=2026-10-04&date_end=2026-10-31
&pay_type=cpm&shows=136&amount=3000
По итогам месяца по каждой паре «рекламодатель ↔ рекламораспространитель» автоматически формируется и сдаётся акт.
Если вы оплатили размещение на бирже htmlweb (например, 13 493 ₽ за сетку каналов) — маркировка
входит в заказ: после публикации боты сами регистрируют публикации и сдают отчёты в ЕРИР, вам ничего
делать не нужно. Проверить состояние можно методом pubs:
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=pubs&limit=50
В ответе по каждой публикации: publisher_inn (владелец канала), период, показы, сумма
и статус отчёта: wait — период не закончился, sent — сдан в ЕРИР,
error — отказ (текст в поле error).
Метод autofill по ссылке на пост возвращает фактические просмотры поста
(не подписчиков канала) и дату публикации — готовые значения для отчёта:
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=autofill
&url=https://max.ru/id615016514444_biz4/AaEAqhyNXl8
Ответ:
{"status":200,"chat":-78581626255460,
"name":"Москва. Мероприятия. Я местный!",
"shows":172,"shows_real":1,"shows_upd":"просмотры поста",
"date_start":"2026-10-04","date_end":"2026-10-04"}
shows_real=1 — это просмотры конкретного поста (счётчик MAX, растёт по мере досмотра).
shows_real=0 — пост недоступен, возвращены подписчики канала: используйте их как оценку
или подставьте фактические показы вручную. Помните: счётчик просмотров «живёт» недолго — снимайте
показания и сдавайте отчёт в течение суток после окончания публикации, потом скорректируйте.
Показы поста растут и после сдачи отчёта, или вы ошиблись в сумме. Метод report_update:
если отчёт ещё не сдан — обновляются его данные; если уже сдан — в ЕРИР отправляется корректировка:
ОРД перезаписывает отчёт по прежнему идентификатору, дублей не создаётся. Корректировать можно сколько угодно раз.
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=report_update
&pub=7
&date_start=2026-10-04&date_end=2026-10-31
&shows=1951&amount=1000
pub — идентификатор публикации из метода pubs. Сумма обязательна —
отчёты без стоимости в ЕРИР не принимаются. Рекомендуемая практика: сдайте предварительный отчёт сразу
после публикации, а финальную корректировку сделайте по окончании периода, когда счётчик просмотров остановился.
Метод inncheck проверяет контрольную сумму ИНН и возвращает реквизиты из ЕГРЮЛ/ЕГРИП —
вы убедитесь, что ИНН принадлежит именно вашему контрагенту:
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=inncheck&inn=615016514444
Ответ:
{"status":200,"item":{"inn":"615016514444",
"name":"ИП Маркина Анна Александровна","status":"ACTIVE","npd":0,"phys":0}}
status — состояние из реестра (ACTIVE — действующая). npd=1 — самозанятый,
phys=1 — физлицо вне ЕГРЮЛ/ЕГРИП: для договора в обоих случаях дополнительно укажите его ФИО
в параметре fio карточки публикации. Неверная контрольная сумма ИНН — ошибка возвращается сразу,
запросы к реестрам не тратятся.
https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=creatives&limit=50
Ответ:
{"status":200,"items":[{"id":23,"erid":"2VtzqvpZDrC","advertiser_inn":"614704334828",
"status":"registered","erir_status":"processing","time":"2026-10-02 10:26:43"},…]}
erir_status — статус обработки токена реестром: processing — принят,
ожидает обработки (до двух суток — норма), verified/ok — подтверждён.
| text | Текст рекламного макета (или медиа + краткий текст) |
| media_url | Ссылка на фото/видео макета (jpg, png, mp4…) |
| urls | Ссылки перехода (кнопки под постом), до 10; в публикации в них подставляется erid |
| advertiser_inn | ИНН рекламодателя — чей товар/услуга рекламируются. Сохраняется в профиле |
| publisher_inn / inn | ИНН рекламораспространителя — владельца канала, где выйдет пост. Совпадает с рекламодателем — самореклама |
| name, category, description | Название/бренд, категория, описание — для ОРД (по умолчанию из текста) |
| kktu | Код ККТУ — категория рекламируемых товаров/услуг, по умолчанию 30.15.1 |
| targeting | Целевая аудитория рекламы |
| note | Примечание для себя (до 500 символов) — никуда не отправляется, видно только вам в кабинете |
| social, social_quota | Социальная реклама / социальная реклама по квоте |
| url (публикация) | Ссылка на опубликованный пост |
| date_start, date_end | Фактический период публикации, ГГГГ-ММ-ДД; в пределах одного месяца, не в будущем |
| pay_type | Тип платного события: cpm — за 1000 показов, cpv, cpa, fixed и др. |
| shows | Фактическое количество показов (просмотров поста) |
| shows_paid | Оплаченное количество показов, если отличается |
| amount | Сумма размещения, ₽ (обязательна для сдачи отчёта; взаимная реклама — 0) |
| cpm | Стоимость 1000 показов/события — если не указана, рассчитается из суммы и показов |
| vat_rate | Ставка НДС: without_vat (по умолчанию), 0, 10, 20 |
| fio | ФИО физлица-контрагента (если inncheck вернул npd=1 или phys=1) — обязательны реквизиты |
Выпуск erid — 20 ₽ (параметр price_token в m=status). Списание — с баланса
htmlweb.ru, при нехватке — с привязанной карты (привязывается при первой оплате в
кабинете). Методы pub, report,
report_update — бесплатно: отчётность в ЕРИР входит в стоимость токена. Неудачный выпуск
(ОРД не принял макет) — списания нет, erid не выпускается.
| Неверный api_key | Ключ из профиля htmlweb.ru, 32 символа. Не подтверждена почта — подтвердите |
| Отчёт без суммы не сдаётся | Укажите amount в публикации или корректировке |
| Неверная контрольная сумма ИНН | Опечатка в ИНН контрагента — исправьте; запросы к реестрам не тратились |
| Организация с таким ИНН не найдена | Юрлицо нет в ЕГРЮЛ. Физлицу (12 знаков) реестры не нужны — укажите его ФИО в параметре fio |
| Маркировка временно недоступна | Смотрите m=status: пополните баланс платформы или дождитесь снятия сбоя |
| Период должен быть в пределах одного месяца | Требование ЕРИР: разбейте длинный период на месячные отчёты |
| MAX сообщает: чат по этой ссылке не найден | Взята устаревшая ссылка на пост — «Копировать ссылку» заново |
Остались вопросы — напишите в поддержку @kdg22.
Другие API htmlweb.ru — каталог API: гео, телефон, ИНН/ЕГРЮЛ, почта, банки, QR, СМС. Проверка реквизитов контрагента — API проверки ИНН, КПП, ОГРН, р/с.