search
Перейти в кабинет

API

APIarrow-up-right (программный интерфейс приложения) позволяет организовать интеграцию вашего собственного приложения с сервисом Впостерarrow-up-right.

hashtag
Ключ доступа

Ключ доступа можно получить в кабинете сервиса в разделе "Разработчикам" или по ссылкеarrow-up-right.

hashtag
Документация

LogoVposter API Swaggervposter.ruchevron-right
Документация Swagger

hashtag
Получить список страниц для отложенного постинга

get

Возвращает перечень доступных страниц и групп, на которые разрешено публиковать контент.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Responses
chevron-right
200

Успешный ответ. Возвращается объект с полем response, содержащим:

  • count — общее количество доступных страниц/групп;
  • items — массив объектов с данными каждой страницы/группы.
application/json
get
/v3/method/groups.get

hashtag
Загрузить файл на сервер

post

Загружает изображение, видео или документ на сервер для последующего использования в постах. После успешной загрузки возвращается JSON, который можно использовать в поле attachments_json при создании поста. Передавать нужно массив с вложениями.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
filestring · binaryRequired

Обязательный. Файл для загрузки (изображение, видео или документ).

Поддерживаемые форматы:

  • Изображения: JPG, JPEG, PNG, GIF, WEBP
  • Видео: MP4, AVI, MOV, MKV, WEBM
  • Документы: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT
Example: файл.jpg
id_groupstringRequired

Обязательный. ID страницы или группы, к которой будет привязан файл. Получается через метод /v3/method/groups.get.

Example: 123456
typestring · enumRequired

Обязательный. Тип загружаемого файла:

  • image — изображение
  • video — видео
  • file — документ
Example: imagePossible values:
Responses
chevron-right
200

Файл успешно загружен. Возвращается объект с полем response.attachments, содержащим массив вложения photo, video или doc. У каждого вложения могут быть свои параметры.

application/json
codestring · enumOptional

Статус ответа

Example: successPossible values:
post
/v3/method/uploads

hashtag
Получить список запланированных постов

get

Возвращает перечень запланированных постов пользователя с возможностью фильтрации, поиска и пагинации.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters
pageinteger · min: 1Optional

Номер страницы для пагинации.

  • Минимальное значение: 1
  • По умолчанию: 1
Default: 1Example: 1
limitinteger · min: 1 · max: 100Optional

Количество записей на странице.

  • Минимальное значение: 1
  • Максимальное значение: 100
  • По умолчанию: 20
Default: 20Example: 20
sortstring · enumOptional

Направление сортировки по дате публикации.

  • asc - по возрастанию (сначала старые)
  • desc - по убыванию (сначала новые)
  • По умолчанию: desc
Default: descExample: descPossible values:
id_groupstringOptional

Фильтр по ID страницы или группы. Возвращаются только посты для указанной группы.

type_socialstring · enumOptional

Фильтр по типу социальной сети. Доступные значения:

  • vk - ВКонтакте
  • tg - Telegram
  • ok - Одноклассники
  • ig_business - Instagram Business
  • max - Max
  • rutube - Rutube
  • fb - Facebook
Possible values:
active_stopstring · enumOptional

Фильтр по статусу активности.

  • 0 - активные посты
  • 1 - остановленные посты
Possible values:
post_daystringOptional

Фильтр по типу расписания.

  • everyday - ежедневные посты
  • Конкретная дата в формате Y-m-d (например, 2024-01-15)
statusstring · enumOptional

Фильтр по статусу поста.

  • active - только активные (не остановленные и с датой в будущем)
  • inactive - остановленные или уже опубликованные
  • all - все посты
  • По умолчанию: all
Default: allExample: allPossible values:
searchstring · min: 1 · max: 255Optional

Поиск по тексту поста. Поиск осуществляется по частичному совпадению.

date_fromstring · date-timeOptional

Начальная дата для фильтрации (включительно). Формат: Y-m-d H:i:s или Y-m-d Пример: 2024-01-01 00:00:00

date_tostring · date-timeOptional

Конечная дата для фильтрации (включительно). Формат: Y-m-d H:i:s или Y-m-d Пример: 2024-12-31 23:59:59

Responses
chevron-right
200

Успешный ответ. Возвращается объект с полем response, содержащим:

  • items — массив объектов с данными каждого поста
  • count — общее количество постов, соответствующих критериям
  • page — текущая страница
  • limit — количество записей на странице
  • total_pages — общее количество страниц
  • filters_applied — примененные фильтры (если были использованы)
application/json
get
/v3/method/posts.get

hashtag
Получить информацию о посте

get

Возвращает информацию о посте по его идентификатору.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters
idintegerRequired

Идентификатор публикации

Example: 12345
Responses
chevron-right
200

Успешный ответ. Возвращается объект с полем response, содержащим:

  • items — массив объекта с данными страницы/группы.
application/json
get
/v3/method/posts.getById

hashtag
Запланировать публикацию поста

post

Создаёт пост в разделе «Отложенные посты» на указанной странице/группе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
id_groupstringRequired

Обязательный. ID страницы или группы, куда будет опубликован пост. Получается через метод /v3/method/groups.get.

Example: 123456
name_autopoststringOptional

Название поста для отображения в запланированных постах. Если не указано, будет сгенерировано автоматически.

Example: Рекламный пост о новой коллекции
primary_attachments_modeinteger · enumOptional

Режим отображения вложений: (для vk)

  • 0 — сетка
  • 1 — карусель
Example: 1Possible values:
type_socialstring · enumRequired

Обязательный. Социальная сеть для публикации:

  • vk — ВКонтакте
  • tg — Telegram
  • ok — Одноклассники
  • ig_business — Instagram Business
  • max — Max
  • rutube — Rutube
  • fb — Facebook
Example: vkPossible values:
date_poststringRequired

Обязательный. Дата и время публикации. Формат: ГГГГ-ММ-ДД ЧЧ:ММ

Example: 2027-02-21 15:40
post_daystring · enumRequired

Обязательный. Периодичность публикации:

  • oneraz — однократно
  • everyday — ежедневно
  • budday — по будням
  • weekends — по выходным
  • every2day — раз в 2 дня
  • every3day — раз в 3 дня
  • и так далее (цифра указывает интервал)
Example: onerazPossible values:
messagestringOptional

Текст публикуемого поста. Поддерживается форматирование для tg и max

Поддерживаемое форматирование HTML в тексте:

  • tg — <b><i><strike><u><span><a><blockquote><blockquote_expandable><code><pre>
  • max — <b><i><code><blockquote><a><h1><strike><u>

Информация по тегам:

  • <b>text</b> — жирный
  • <i>text</i> — курсив
  • <strike>text</strike> — зачёркнутый
  • <span class="tg-spoiler">text</span> — скрытый
  • <a href="link">text</a> — ссылка
  • <blockquote class="blockquote">text<blockquote> — цитата
  • <blockquote_expandable class="expandable">text<blockquote_expandable> — цитата с раскрытием
  • <pre class="code-block">text</pre> — код
  • <code>text</code> — моноширинный
  • <h1 class="title">text</h1> — заголовок
Example: Наша новая коллекция уже в продаже! 🎉
repost_objectstringOptional

Ссылка на пост для репоста.

Поддерживаемые соцсети:

  • vk — ВКонтакте
  • tg — Telegram
  • ok — Одноклассники
Example: https://vk.com/wall66748_3675
repost_commentstringOptional

Комментарий к репосту (если выполняется репост).

Поддерживаемые соцсети:

  • vk — ВКонтакте
  • tg — Telegram
  • ok — Одноклассники
Example: Отличный пост, делюсь с подписчиками!
delete_post_datestringOptional

Дата автоматического удаления поста из сервиса (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28
delete_clockstringOptional

Час автоматического удаления поста из соцсети. Значение от 0 до 4382.

Example: 23
delete_minutesstringOptional

Минута автоматического удаления поста из соцсети. Значение от 0 до 59.

Example: 59
stop_post_datestringOptional

Дата автоматического приостановления поста на сервисе (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28
signedinteger · enumOptional

Добавлять подпись от имени автора: (для vk)

  • 0 — не добавлять
  • 1 — добавлять
Example: 0Possible values:
mute_notificationsinteger · enumOptional

Отключить уведомления о публикации: (для vk, ok, tg, max)

  • 0 — уведомления включены
  • 1 — уведомления отключены
Example: 0Possible values:
close_commentsinteger · enumOptional

Закрыть комментарии к посту: (для vk, ok)

  • 0 — комментарии открыты
  • 1 — комментарии закрыты
Example: 0Possible values:
wall_pininteger · enumOptional

Закрепить пост на стене: (для vk, tg, max)

  • 0 — не закреплять
  • 1 — закрепить
Example: 0Possible values:
wall_unpin_datestringOptional

Дата и время открепления поста (если он был закреплён). Формат: ГГГГ-ММ-ДД ЧЧ:ММ (для vk, tg, max)

Example: 2025-02-28 15:40
co_owner_idsstringOptional

Пригласить соавторов для vk. Укажите VK ID соавторов через запятую. ID сообществ указывайте через знак "-". Лимит 4 соавтора!

Example: -79668981
del_taskinteger · enumOptional

Удалить пост из сервиса после публикации:

  • 0 — оставить в сервисе
  • 1 — удалить после публикации из сервиса
Example: 0Possible values:
donut_typeinteger · enumOptional

Видимость для VK Donut: (для vk)

  • 0 — Неограниченно
  • 1 — На 1 день
  • 2 — На 2 дня
  • 3 — На 3 дня
  • 4 — На 4 дня
  • 5 — На 5 дней
  • 6 — На 6 дней
  • 7 — На 7 дней
Example: 0Possible values:
attachmentsstringOptional

Старый формат. Любые вложения из VK: (для vk)

Если объектов несколько, укажите их через запятую ,

Формат описания медиавложения: {type}{owner_id}_{media_id}, где:

  • type — тип медиавложения:
    • photo — фотография
    • video — видеозапись
    • audio — аудиозапись
    • doc — файл
    • poll — опрос
    • audio_playlist — плейлист с аудио
    • owner_id — идентификатор владельца медиавложения. Идентификатор сообщества должен начинаться со знака -
    • media_id — идентификатор медиавложения

Данный формат позволяет передавать любые вложения из VK. Это тот же формат, который используется в VK API.

Example: photo-79668981_457342016,photo-79668981_457341976
attachments_jsonobjectOptional

Новый формат. Визуальные вложения к посту (изображения, видео, документы и т.д.).

Массив объектов с данными о вложениях.

Каждый объект массива содержит:

Фото (для vk, ok, fb, ig_business, tg, max)

  • id (number) — уникальный идентификатор вложения
  • type (string) — тип вложения (photo)
  • preview (string) — URL превью изображения
  • original (string) — URL оригинального изображения
  • owner_id (number) — ID владельца
  • access_key (string) — ключ доступа

Видео (для vk, ok, fb, tg, rutube, max)

  • id (number) — уникальный идентификатор вложения
  • size (number) — размер видео в байтах
  • type (string) — тип вложения (video)
  • title (string) — название видео
  • preview (string) — URL превью изображения
  • duration (number) — длительность в секундах
  • owner_id (number) — ID владельца
  • type_video (string) — тип видео (video или short_video)

Аудио (для vk)

  • id (number) — уникальный идентификатор вложения
  • type (string) — тип вложения (audio)
  • title (string) — название
  • artist (string) — исполнитель
  • duration (number) — длительность в секундах
  • owner_id (number) — ID владельца

Документ (для vk, tg, max)

  • id (number) — уникальный идентификатор вложения
  • ext (string) — формат файла, например docx
  • url (string) — прямая ссылка на файл
  • size (number) — размер файла в байтах
  • type (string) — тип вложения (doc)
  • title (string) — название документа
  • owner_id (number) — ID владельца

Опрос (для vk, ok, tg)

  • id (number) — всегда одно значение 600
  • type (string) — тип вложения (poll)
  • answers (items) — массив ответов ["Первый вариант", "Второй вариант", "Третий вариант"]
  • question (string) — заголовок опроса

Карта (для vk, ok)

  • id (number) — всегда одно значение 700
  • type (string) — тип вложения (geo)
  • lat (items) — широта
  • long (items) — долгота
  • title (string) — название местоположения

Источник (для vk)

  • id (number) — всегда одно значение 900
  • url (string) — ссылка на источник
  • type (string) — тип вложения (copyright)

Первый комментарий (для vk)

  • id (number) — всегда одно значение 800
  • text (string) — текст комментария
  • type (string) — тип вложения (comment)

Сниппет ссылки (для vk, ok, fb, tg)

  • id (number) — всегда одно значение 555
  • url (string) — HTTPS ссылка
  • type (string) — тип вложения (link)
  • image (string) — URL превью изображения
  • domain (string) — домен страницы, например, vposter.ru
  • title (string) — название страницы
  • description (string) — короткое описание страницы
  • link_photo_id (string) — идентификатор изображения в VK

Кнопка действия (для vk)

  • id (number) — всегда одно значение 378
  • type (string) — тип вложения (action_button)
  • text_button (string) — текст кнопки (Написать сообществу (открывает чат с сообществом), Больше постов — в канале (переводит в канал сообщества), Смотреть товары (ведёт на витрину магазина), Поддержать автора (открывает список уровней VK Donut))
  • type_button (string) — тип кнопки (message_to_community, message_to_channel, open_market, donut_levels)

Кнопки (для tg, max)

  • id (number) — всегда одно значение 1000
  • type (string) — тип вложения (button_tg)
  • buttons_link (items) — массив ссылок по порядку от 1-10 (["https://vposter.ru/", "https://vposter.ru/"])
  • buttons_name (items) — массив название по порядку от 1-10 (["Кнопка 1", "Кнопка 2"])

Важно: Используйте либо attachments (старый формат), либо attachments_json (новый формат). Не используйте оба параметра одновременно.

Example: [{"id":457749080,"type":"photo","preview":"https://sun9-44.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0","original":"https://sun9-44.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu","owner_id":116945277,"access_key":"74781521bc8879f57c"},{"id":457749081,"type":"photo","preview":"https://sun9-81.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0","original":"https://sun9-81.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu","owner_id":116945277,"access_key":"9440bb15a589dd577f"}]
Responses
chevron-right
200

Пост успешно запланирован. Ответ может содержать идентификатор созданного поста.

application/json
post
/v3/method/posts.create

hashtag
Отредактировать пост

put

Редактирует пост в разделе «Отложенные посты» на указанной странице/группе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
idintegerRequired

Обязательный. ID поста на сервисе

Example: 123456
id_groupstringRequired

Обязательный. ID страницы или группы, куда будет опубликован пост. Получается через метод /v3/method/groups.get.

Example: 123456
name_autopoststringOptional

Название поста для отображения в запланированных постах. Если не указано, будет сгенерировано автоматически.

Example: Рекламный пост о новой коллекции
primary_attachments_modeinteger · enumOptional

Режим отображения вложений: (для vk)

  • 0 — сетка
  • 1 — карусель
Example: 1Possible values:
type_socialstring · enumRequired

Обязательный. Социальная сеть для публикации:

  • vk — ВКонтакте
  • tg — Telegram
  • ok — Одноклассники
  • ig_business — Instagram Business
  • max — Max
  • rutube — Rutube
  • fb — Facebook
Example: vkPossible values:
date_poststringRequired

Обязательный. Дата и время публикации. Формат: ГГГГ-ММ-ДД ЧЧ:ММ

Example: 2027-02-21 15:40
post_daystring · enumRequired

Обязательный. Периодичность публикации:

  • oneraz — однократно
  • everyday — ежедневно
  • budday — по будням
  • weekends — по выходным
  • every2day — раз в 2 дня
  • every3day — раз в 3 дня
  • и так далее (цифра указывает интервал)
Example: onerazPossible values:
messagestringOptional

Текст публикуемого поста. Поддерживается форматирование для tg и max

Поддерживаемое форматирование HTML в тексте:

  • tg — <b><i><strike><u><span><a><blockquote><blockquote_expandable><code><pre>
  • max — <b><i><code><blockquote><a><h1><strike><u>

Информация по тегам:

  • <b>text</b> — жирный
  • <i>text</i> — курсив
  • <strike>text</strike> — зачёркнутый
  • <span class="tg-spoiler">text</span> — скрытый
  • <a href="link">text</a> — ссылка
  • <blockquote class="blockquote">text<blockquote> — цитата
  • <blockquote_expandable class="expandable">text<blockquote_expandable> — цитата с раскрытием
  • <pre class="code-block">text</pre> — код
  • <code>text</code> — моноширинный
  • <h1 class="title">text</h1> — заголовок
Example: Наша новая коллекция уже в продаже! 🎉
repost_objectstringOptional

Ссылка на пост для репоста.

Поддерживаемые соцсети:

  • vk — ВКонтакте
  • tg — Telegram
  • ok — Одноклассники
Example: https://vk.com/wall66748_3675
repost_commentstringOptional

Комментарий к репосту (если выполняется репост).

Поддерживаемые соцсети:

  • vk — ВКонтакте
  • tg — Telegram
  • ok — Одноклассники
Example: Отличный пост, делюсь с подписчиками!
delete_post_datestringOptional

Дата автоматического удаления поста из сервиса (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28
delete_clockstringOptional

Час автоматического удаления поста из соцсети. Значение от 0 до 4382.

Example: 23
delete_minutesstringOptional

Минута автоматического удаления поста из соцсети. Значение от 0 до 59.

Example: 59
stop_post_datestringOptional

Дата автоматического приостановления поста на сервисе (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28
signedinteger · enumOptional

Добавлять подпись от имени автора: (для vk)

  • 0 — не добавлять
  • 1 — добавлять
Example: 0Possible values:
mute_notificationsinteger · enumOptional

Отключить уведомления о публикации: (для vk, ok, tg, max)

  • 0 — уведомления включены
  • 1 — уведомления отключены
Example: 0Possible values:
close_commentsinteger · enumOptional

Закрыть комментарии к посту: (для vk, ok)

  • 0 — комментарии открыты
  • 1 — комментарии закрыты
Example: 0Possible values:
wall_pininteger · enumOptional

Закрепить пост на стене: (для vk, tg, max)

  • 0 — не закреплять
  • 1 — закрепить
Example: 0Possible values:
wall_unpin_datestringOptional

Дата и время открепления поста (если он был закреплён). Формат: ГГГГ-ММ-ДД ЧЧ:ММ (для vk, tg, max)

Example: 2025-02-28 15:40
co_owner_idsstringOptional

Пригласить соавторов для vk. Укажите VK ID соавторов через запятую. ID сообществ указывайте через знак "-". Лимит 4 соавтора!

Example: -79668981
del_taskinteger · enumOptional

Удалить пост из сервиса после публикации:

  • 0 — оставить в сервисе
  • 1 — удалить после публикации из сервиса
Example: 0Possible values:
donut_typeinteger · enumOptional

Видимость для VK Donut: (для vk)

  • 0 — Неограниченно
  • 1 — На 1 день
  • 2 — На 2 дня
  • 3 — На 3 дня
  • 4 — На 4 дня
  • 5 — На 5 дней
  • 6 — На 6 дней
  • 7 — На 7 дней
Example: 0Possible values:
attachmentsstringOptional

Старый формат. Любые вложения из VK: (для vk)

Если объектов несколько, укажите их через запятую ,

Формат описания медиавложения: {type}{owner_id}_{media_id}, где:

  • type — тип медиавложения:
    • photo — фотография
    • video — видеозапись
    • audio — аудиозапись
    • doc — файл
    • poll — опрос
    • audio_playlist — плейлист с аудио
    • owner_id — идентификатор владельца медиавложения. Идентификатор сообщества должен начинаться со знака -
    • media_id — идентификатор медиавложения

Данный формат позволяет передавать любые вложения из VK. Это тот же формат, который используется в VK API.

Example: photo-photo-79668981_457342016,photo-79668981_457341976
attachments_jsonstringOptional

Новый формат. Визуальные вложения к посту (изображения, видео, документы и т.д.).

Массив объектов с данными о вложениях.

Каждый объект массива содержит:

Фото (для vk, ok, fb, ig_business, tg, max)

  • id (number) — уникальный идентификатор вложения
  • type (string) — тип вложения (photo)
  • preview (string) — URL превью изображения
  • original (string) — URL оригинального изображения
  • owner_id (number) — ID владельца
  • access_key (string) — ключ доступа

Видео (для vk, ok, fb, tg, rutube, max)

  • id (number) — уникальный идентификатор вложения
  • size (number) — размер видео в байтах
  • type (string) — тип вложения (video)
  • title (string) — название видео
  • preview (string) — URL превью изображения
  • duration (number) — длительность в секундах
  • owner_id (number) — ID владельца
  • type_video (string) — тип видео (video или short_video)

Аудио (для vk)

  • id (number) — уникальный идентификатор вложения
  • type (string) — тип вложения (audio)
  • title (string) — название
  • artist (string) — исполнитель
  • duration (number) — длительность в секундах
  • owner_id (number) — ID владельца

Документ (для vk, tg, max)

  • id (number) — уникальный идентификатор вложения
  • ext (string) — формат файла, например docx
  • url (string) — прямая ссылка на файл
  • size (number) — размер файла в байтах
  • type (string) — тип вложения (doc)
  • title (string) — название документа
  • owner_id (number) — ID владельца

Опрос (для vk, ok, tg)

  • id (number) — всегда одно значение 600
  • type (string) — тип вложения (poll)
  • answers (items) — массив ответов ["Первый вариант", "Второй вариант", "Третий вариант"]
  • question (string) — заголовок опроса

Карта (для vk, ok)

  • id (number) — всегда одно значение 700
  • type (string) — тип вложения (geo)
  • lat (items) — широта
  • long (items) — долгота
  • title (string) — название местоположения

Источник (для vk)

  • id (number) — всегда одно значение 900
  • url (string) — ссылка на источник
  • type (string) — тип вложения (copyright)

Первый комментарий (для vk)

  • id (number) — всегда одно значение 800
  • text (string) — текст комментария
  • type (string) — тип вложения (comment)

Сниппет ссылки (для vk, ok, fb, tg)

  • id (number) — всегда одно значение 555
  • url (string) — HTTPS ссылка
  • type (string) — тип вложения (link)
  • image (string) — URL превью изображения
  • domain (string) — домен страницы, например, vposter.ru
  • title (string) — название страницы
  • description (string) — короткое описание страницы
  • link_photo_id (string) — идентификатор изображения в VK

Кнопка действия (для vk)

  • id (number) — всегда одно значение 378
  • type (string) — тип вложения (action_button)
  • text_button (string) — текст кнопки (Написать сообществу (открывает чат с сообществом), Больше постов — в канале (переводит в канал сообщества), Смотреть товары (ведёт на витрину магазина), Поддержать автора (открывает список уровней VK Donut))
  • type_button (string) — тип кнопки (message_to_community, message_to_channel, open_market, donut_levels)

Кнопки (для tg, max)

  • id (number) — всегда одно значение 1000
  • type (string) — тип вложения (button_tg)
  • buttons_link (items) — массив ссылок по порядку от 1-10 (["https://vposter.ru/", "https://vposter.ru/"])
  • buttons_name (items) — массив название по порядку от 1-10 (["Кнопка 1", "Кнопка 2"])

Важно: Используйте либо attachments (старый формат), либо attachments_json (новый формат). Не используйте оба параметра одновременно.

Example: [ { "id": 457749080, "type": "photo", "preview": "https://sun9-44.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0", "original": "https://sun9-44.vkuserphoto.ru/s/v1/ig2/SIXJehNSqRY1nyfc7s-fB9-FmQ8LCWaVl-vN0FGIDulCNpQSt_aF-20Rki6dVPsL02v0hWR4b6p5OC6DXtNhZNi9.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu", "owner_id": 116945277, "access_key": "74781521bc8879f57c" }, { "id": 457749081, "type": "photo", "preview": "https://sun9-81.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu&cs=640x0", "original": "https://sun9-81.vkuserphoto.ru/s/v1/ig2/iUTfrZvhO6IpMFJAD7a1mc6-X2ALSktFjosUGtweGp_fGlADb1DINs6ZZsf5VOp8ohrj1lIWBUeiIRBnB98V7T44.jpg?quality=95&as=32x57,48x85,72x128,108x192,160x284,240x427,360x640,480x853,540x960,640x1138,720x1280,1080x1920,1280x2276,1440x2560&from=bu", "owner_id": 116945277, "access_key": "9440bb15a589dd577f" } ]
Responses
chevron-right
200

Пост успешно отредактирован. Ответ может содержать идентификатор отредактированного поста.

application/json
put
/v3/method/posts.edit

hashtag
Удалить пост

delete

Удаляет пост на сервисе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
idintegerRequired

Обязательный. ID поста на сервисе.

Example: 123456
Responses
chevron-right
200

Пост успешно удален.

application/json
delete
/v3/method/posts.delete

hashtag
Приостановить пост

post

Приостанавливает пост на сервисе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
idintegerRequired

Обязательный. ID отложенного поста на сервисе.

Example: 123456
Responses
chevron-right
200

Пост успешно приостановлена.

application/json
post
/v3/method/posts.stop

hashtag
Включить пост

post

Включает пост на сервисе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
idintegerRequired

Обязательный. ID отложенного поста на сервисе.

Example: 123456
Responses
chevron-right
200

Пост успешно включен.

application/json
post
/v3/method/posts.activate

hashtag
Получить список запланированных историй

get

Возвращает перечень запланированных историй пользователя с возможностью фильтрации, поиска и пагинации.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters
pageinteger · min: 1Optional

Номер страницы для пагинации.

  • Минимальное значение: 1
  • По умолчанию: 1
Default: 1Example: 1
limitinteger · min: 1 · max: 100Optional

Количество записей на странице.

  • Минимальное значение: 1
  • Максимальное значение: 100
  • По умолчанию: 20
Default: 20Example: 20
sortstring · enumOptional

Направление сортировки по дате публикации.

  • asc - по возрастанию (сначала старые)
  • desc - по убыванию (сначала новые)
  • По умолчанию: desc
Default: descExample: descPossible values:
id_groupstringOptional

Фильтр по ID страницы или группы. Возвращаются только посты для указанной группы.

type_socialstring · enumOptional

Фильтр по типу социальной сети. Доступные значения:

  • vk - ВКонтакте
  • ok - Одноклассники
  • ig_business - Instagram Business
Possible values:
active_stopstring · enumOptional

Фильтр по статусу активности.

  • 0 - активные истории
  • 1 - остановленные истории
Possible values:
post_daystringOptional

Фильтр по типу расписания.

  • everyday - ежедневные истории
  • Конкретная дата в формате Y-m-d (например, 2024-01-15)
statusstring · enumOptional

Фильтр по статусу истории.

  • active - только активные (не остановленные и с датой в будущем)
  • inactive - остановленные или уже опубликованные
  • all - все посты
  • По умолчанию: all
Default: allExample: allPossible values:
searchstring · min: 1 · max: 255Optional

Поиск по названию истории. Поиск осуществляется по частичному совпадению.

date_fromstring · date-timeOptional

Начальная дата для фильтрации (включительно). Формат: Y-m-d H:i:s или Y-m-d Пример: 2024-01-01 00:00:00

date_tostring · date-timeOptional

Конечная дата для фильтрации (включительно). Формат: Y-m-d H:i:s или Y-m-d Пример: 2024-12-31 23:59:59

Responses
chevron-right
200

Успешный ответ. Возвращается объект с полем response, содержащим:

  • items — массив объектов с данными каждой истории
  • count — общее количество историй, соответствующих критериям
  • page — текущая страница
  • limit — количество историй на странице
  • total_pages — общее количество страниц
  • filters_applied — примененные фильтры (если были использованы)
application/json
get
/v3/method/stories.get

hashtag
Получить информацию о истории

get

Возвращает информацию о истории по его идентификатору.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters
idintegerRequired

Идентификатор публикации

Example: 12345
Responses
chevron-right
200

Успешный ответ. Возвращается объект с полем response, содержащим:

  • items — массив объекта с данными страницы/группы.
application/json
get
/v3/method/stories.getById

hashtag
Запланировать публикацию истории

post

Создаёт историю в разделе «Отложенные истории» на указанной странице/группе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
id_groupstringRequired

Обязательный. ID страницы или группы, куда будет опубликована история. Получается через метод /v3/method/groups.get.

Example: 123456
name_autopoststringOptional

Название истории для отображения в запланированных историях (видно только вам).

Example: Рекламная история
stories_timeinteger · enumOptional

Время показа истории:

  • 0 — 24 часа
  • 1 — 1 час
  • 2 — 12 часов
  • 3 — 48 часов
Example: 0Possible values:
type_socialstring · enumRequired

Обязательный. Социальная сеть для публикации:

  • vk — ВКонтакте
  • ok — Одноклассники
  • ig_business — Instagram Business
Example: vkPossible values:
date_poststringRequired

Обязательный. Дата и время публикации. Формат: ГГГГ-ММ-ДД ЧЧ:ММ

Example: 2025-02-21 15:40
post_daystring · enumRequired

Обязательный. Периодичность публикации (аналогично постам).

Example: onerazPossible values:
stories_imagestringRequired

Обязательный. URL изображения для истории.

Example: https://example.com/image.jpg
stories_link_urlstringOptional

URL для ссылки в истории для vk и ok.

Example: https://example.com
stories_link_textstringOptional

Текст ссылки в истории для vk и ok.

Возможные значения:

  • to_store — В магазин
  • more — Еще
  • book — Забронировать
  • order — Заказать
  • enroll — Записаться
  • fill — Заполнить
  • signup — Зарегистрироваться
  • buy — Купить
  • ticket — Купить билет
  • write — Написать
  • open — Открыть
  • learn_more — Подробнее
  • view — Посмотреть
  • go_to — Перейти
  • contact — Связаться
  • watch — Смотреть
  • play — Слушать
  • install — Установить
  • read — Читать
  • vote — Голосовать
  • congratulate — Поздравить
  • game — Играть
  • to_memories_app — К воспоминаниям
  • calendar — Открыть календарь
  • watch_clip — Смотреть клип
  • make_clip — Снять клип
  • participate — Участвовать
  • open_mask — Открыть маску
  • try_on — Примерить
  • try — Попробовать
  • profile — Открыть профиль
  • attach_wall — Открыть запись
  • attach_article — Читать статью
  • attach_poll — Открыть опрос
  • attach_story — Смотреть историю
  • attach_audio — Слушать
  • attach_audio_playlist — Открыть плейлист
  • attach_audio_album — Открыть альбом
  • attach_video — Смотреть видео
  • attach_video_live — К трансляции
  • attach_photo — Открыть фото
  • attach_album — Открыть фотоальбом
  • attach_page — Открыть страницу
  • attach_market — Открыть товар
  • attach_link — Открыть ссылку
  • attach_artist — Перейти к музыканту
  • attach_narrative — Смотреть момент
  • attach_podcast — Слушать подкаст
Example: go_to
delete_post_datestringOptional

Дата автоматического удаления истории из сервиса (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28
delete_clockstringOptional

Час автоматического удаления истории из соцсети (0-4382).

Example: 23
delete_minutesstringOptional

Минута автоматического удаления истории из соцсети (0-59).

Example: 59
stop_post_datestringOptional

Дата автоматического приостановления истории на сервисе (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28
del_taskinteger · enumOptional

Удалить историю из сервиса после публикации:

  • 0 — оставить в сервисе
  • 1 — удалить после публикации из сервиса
Example: 0Possible values:
Responses
chevron-right
200

История успешно запланирована. Ответ может содержать идентификатор созданной истории.

application/json
post
/v3/method/stories.create

hashtag
Отредактировать историю

put

Редактирует историю в разделе «Отложенные истории» на указанной странице/группе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
idintegerRequired

Обязательный. ID истории на сервисе

Example: 123456
id_groupstringRequired

Обязательный. ID страницы или группы, куда будет опубликована история. Получается через метод /v3/method/groups.get.

Example: 123456
name_autopoststringOptional

Название истории для отображения в запланированных историях (видно только вам).

Example: Рекламная история
stories_timeinteger · enumOptional

Время показа истории:

  • 0 — 24 часа
  • 1 — 1 час
  • 2 — 12 часов
  • 3 — 48 часов
Example: 0Possible values:
type_socialstring · enumRequired

Обязательный. Социальная сеть для публикации:

  • vk — ВКонтакте
  • ok — Одноклассники
  • ig_business — Instagram Business
Example: vkPossible values:
date_poststringRequired

Обязательный. Дата и время публикации. Формат: ГГГГ-ММ-ДД ЧЧ:ММ

Example: 2025-02-21 15:40
post_daystring · enumRequired

Обязательный. Периодичность публикации (аналогично постам).

Example: onerazPossible values:
stories_imagestringRequired

Обязательный. URL изображения для истории.

Example: https://example.com/image.jpg
stories_link_urlstringOptional

URL для ссылки в истории для vk и ok.

Example: https://example.com
stories_link_textstringOptional

Текст ссылки в истории для vk и ok.

Возможные значения:

  • to_store — В магазин
  • more — Еще
  • book — Забронировать
  • order — Заказать
  • enroll — Записаться
  • fill — Заполнить
  • signup — Зарегистрироваться
  • buy — Купить
  • ticket — Купить билет
  • write — Написать
  • open — Открыть
  • learn_more — Подробнее
  • view — Посмотреть
  • go_to — Перейти
  • contact — Связаться
  • watch — Смотреть
  • play — Слушать
  • install — Установить
  • read — Читать
  • vote — Голосовать
  • congratulate — Поздравить
  • game — Играть
  • to_memories_app — К воспоминаниям
  • calendar — Открыть календарь
  • watch_clip — Смотреть клип
  • make_clip — Снять клип
  • participate — Участвовать
  • open_mask — Открыть маску
  • try_on — Примерить
  • try — Попробовать
  • profile — Открыть профиль
  • attach_wall — Открыть запись
  • attach_article — Читать статью
  • attach_poll — Открыть опрос
  • attach_story — Смотреть историю
  • attach_audio — Слушать
  • attach_audio_playlist — Открыть плейлист
  • attach_audio_album — Открыть альбом
  • attach_video — Смотреть видео
  • attach_video_live — К трансляции
  • attach_photo — Открыть фото
  • attach_album — Открыть фотоальбом
  • attach_page — Открыть страницу
  • attach_market — Открыть товар
  • attach_link — Открыть ссылку
  • attach_artist — Перейти к музыканту
  • attach_narrative — Смотреть момент
  • attach_podcast — Слушать подкаст
Example: go_to
delete_post_datestringOptional

Дата автоматического удаления истории из сервиса (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28
delete_clockstringOptional

Час автоматического удаления истории из соцсети (0-4382).

Example: 23
delete_minutesstringOptional

Минута автоматического удаления истории из соцсети (0-59).

Example: 59
stop_post_datestringOptional

Дата автоматического приостановления истории на сервисе (если требуется). Формат: ГГГГ-ММ-ДД

Example: 2025-02-28
del_taskinteger · enumOptional

Удалить историю из сервиса после публикации:

  • 0 — оставить в сервисе
  • 1 — удалить после публикации из сервиса
Example: 0Possible values:
Responses
chevron-right
200

История успешно отредактирована. Ответ может содержать идентификатор созданной истории.

application/json
put
/v3/method/stories.edit

hashtag
Удалить историю

delete

Удаляет историю на сервисе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
idintegerRequired

Обязательный. ID истории на сервисе.

Example: 123456
Responses
chevron-right
200

История успешно удалена.

application/json
delete
/v3/method/stories.delete

hashtag
Приостановить историю

post

Приостанавливает историю на сервисе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
idintegerRequired

Обязательный. ID отложенной истории на сервисе.

Example: 123456
Responses
chevron-right
200

История успешно приостановлена.

application/json
post
/v3/method/stories.stop

hashtag
Включить историю

post

Включает историю на сервисе.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Body
idintegerRequired

Обязательный. ID отложенноq историb на сервисе.

Example: 123456
Responses
chevron-right
200

История успешно включена.

application/json
post
/v3/method/stories.activate

hashtag
Получение списка ККТУ (Классификатор товаров и услуг)

get

Возвращает список ККТУ с возможностью фильтрации по названию и коду. Метод работает с GET запросами. Все параметры передаются в query string.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters
searchstringOptional

Поиск по названию (регистронезависимый)

Example: магазин
qstringOptional

Альтернативный параметр для поиска по названию

Example: одежда
codestringOptional

Фильтр по началу кода

Example: 10.
pageinteger · min: 1Optional

Номер страницы для пагинации

Default: 1Example: 1
per_pageinteger · min: 1 · max: 1000Optional

Количество элементов на странице

Default: 50Example: 20
Responses
chevron-right
200

Успешный ответ

application/json
successbooleanOptionalExample: true
countintegerOptionalExample: 1
get
/v3/method/kktu.get

hashtag
Получение списка стран (ОКСМ - Общероссийский классификатор стран мира)

get

Возвращает список стран по классификатору ОКСМ с возможностью фильтрации. Данные загружаются из внешнего источника и содержат коды стран и их названия. Метод работает с GET запросами. Все параметры передаются в query string.

Authorizations
AuthorizationstringRequired

Bearer‑токен, полученный через vposter.ru/dev. Передаётся в заголовке запроса: Authorization: Bearer <access_token>

Query parameters
searchstringOptional

Поиск по названию страны или коду (регистронезависимый)

Example: Грузия
qstringOptional

Альтернативный параметр для поиска по названию или коду

Example: Беларусь
idstringOptional

Фильтр по точному коду страны (трехзначный цифровой код)

Example: 112
idsstringOptional

Фильтр по нескольким кодам стран (через запятую)

Example: 112,268
pageinteger · min: 1Optional

Номер страницы для пагинации

Default: 1Example: 1
per_pageinteger · min: 1 · max: 1000Optional

Количество элементов на странице

Default: 50Example: 20
Responses
chevron-right
200

Успешный ответ

application/json
get
/v3/method/oksm.get
PreviousОбучающие материалы

Last updated