Docs
Пошук документації...⌘K

Публікації

API + MCP
GET/v3/social-media/posts

Запити до цього ендпоїнта безкоштовні та не витрачають жодних одиниць API.

Параметри запиту

statusstringОбов’язково

Етап життєвого циклу публікування допису.

Дозволені значення:publishedscheduleddraftfaileddeleted
channel_idsstring

Список ідентифікаторів каналів, розділених комами, для фільтрування.

author_idsstring

Список ідентифікаторів користувачів-авторів, розділених комами, для фільтрування.

search_querystring

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

date_fromstring (date)

Дата початку історичного періоду у форматі YYYY-MM-DD.

date_tostring (date)

Дата завершення історичного періоду у форматі YYYY-MM-DD.

order_bystring

Поле сортування для дописів. Сортування за метриками застосовується лише до опублікованих дописів.

Дозволені значення:dateviewsunique_viewscommentslikes
order_directionstring

Порядок, у якому повертаються результати: за зростанням або за спаданням.

Дозволені значення:ascdesc
limitinteger

Кількість результатів, які потрібно повернути.

За Замовчуванням:50
offsetinteger

Кількість результатів, які потрібно пропустити.

За Замовчуванням:0
outputstring

Формат виводу.

Дозволені значення:jsonphp

Відповіді

postsarray<object>
author_idstring or null

Унікальний ідентифікатор автора.

author_namestring or null

Ім’я автора.

auto_commentstring or null

Текст автокоментаря, що публікується після публікації запису.

channelsarray<object>

Канали соціальних мереж, пов’язані з публікацією.

channel_idstring
channel_kindstring
channel_usernamestring
channel_display_namestring
channel_profile_image_urlstring (url) or null
created_atstring (date-time)

Часова позначка, коли автор створив допис.

external_post_idstring or null

Ідентифікатор допису, специфічний для платформи.

permalinkstring or null

URL опублікованої публікації на платформі.

post_idinteger

Унікальний ідентифікатор публікації.

status_timestampstring

Позначка часу, пов’язана з поточним статусом.

text_contentstring

Текстовий вміст публікації.