Перейти до основного вмісту
POST
Отримайте аналітику та демографічні дані щодо соціального профілю користувача, як-от покази, перегляди та підписники. Наразі доступно для Bluesky, Facebook Pages, Google My Business, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok, X/Twitter та YouTube.
Facebook: деякі метрики охоплення та відео були вилучені Meta (15 червня 2026 року). Meta видалила метрики Insights unique impression та 3-second video-view (unique) у всіх версіях Graph API, тож об’єкт Facebook analytics більше не повертає сімейство pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*, pagePostsServedImpressionsOrganicUnique) або pageVideoViewsUnique. Використовуйте pageMediaView для reach (заплановано наступника Total Unique Media Views). pagePostEngagements, pageVideoViews та pageVideoViewsPaid не зачеплені. Довідка: Upcoming API Changes — June 15, 2026.
  • Аналітика сторінок Facebook доступна лише для Pages з 100 і більше лайками, як-от демографічні дані. Facebook зазвичай оновлює свої метрики раз на 24 години.
  • Instagram може знадобитися до 48 годин для обчислення аналітичних даних. Аналітика кількості підписників недоступна для облікових записів з менш ніж 100 підписниками. Демографічні метрики повертають лише топ-45 виконавців, у розрахунках демографічних метрик використовуються лише глядачі, для яких у нас є демографічні дані, а демографічні дані не повертаються, якщо у користувача Instagram менше 100 engagements за останні 30 днів.
  • При отриманні аналітики соціальних мереж Instagram демографічна інформація може не з’являтися у відповіді для окремих метрик. Демографічна інформація з’явиться, коли метрики матимуть більше 100 людей у кожній розбивці. Див. Instagram Analytics Demographics Warning для отримання додаткової інформації.
  • LinkedIn підтримує як аналітику Company Page, так і аналітику особистих (member) профілів. Для особистих профілів об’єкт analytics містить lifetime followersCount, щоденний приріст підписників у followersDaily[] та агрегатні метрики постів (impressionCount, uniqueImpressionsCount, likeCount, commentCount, shareCount). Суми LinkedIn count є остаточно узгодженими, але не негайно узгодженими, і в деяких випадках можуть займати до 24-48 годин. Агрегатні shareCount, likeCount та commentCount для особистих профілів надаються за принципом “best-effort” і можуть трохи відрізнятися від чисел, показаних в інтерфейсі LinkedIn.
  • TikTok може знадобитися 24-48 годин для оновлення аналітичних даних, як-от перегляди відео, демографія, лайки, поширення та коментарі.
  • Див. endpoint post analytics для отримання додаткової інформації.

Параметри заголовків

Параметри тіла

platforms
array
обов'язково
Платформи соціальних мереж для отримання аналітики. Приймає масив рядків зі значеннями:
quarters
integer
Вказує, скільки кварталів історичних даних повертати. Квартал — це:
  • 85 днів для Facebook
  • 90 днів для Instagram, TikTok та YouTube
  • 90 днів для Snapchat (обмежено 1 кварталом / максимум 90 днями через обмеження Snapchat API)
Доступно для платформ Facebook, Instagram, Snapchat, TikTok та YouTube. Дійсні значення: 1–4. Лише значення більші за 0 активують фільтрацію за датою.Фільтрація за датою (Instagram та TikTok): Фільтрація за датою активна, коли daily=true АБО quarters > 0. Якщо ні daily, ні quarters не надано, повертаються дані за весь час без застосування фільтра за датою.Примітка: quarters: 0 тепер розглядається як відсутність діапазону дат (дані за весь час). Раніше quarters: 0 розглядався як quarters: 1.
daily
boolean
за замовчуванням:false
Коли встановлено true, повертає аналітичні дані як щоденні значення часового ряду замість агрегованих сум. Ця опція доступна лише для платформ Facebook, Instagram, Snapchat, TikTok та YouTube. Через великий розмір даних рекомендується використання стиснення.Для Instagram і TikTok встановлення daily=true також активує фільтрацію за датою з використанням меншого вікна кварталів за замовчуванням.Instagram reach: З daily=true відповідь Instagram повертає вкладений об’єкт reach (що містить period та часовий ряд values) замість скалярного поля reachCount, яке повертається в режимі non-daily.
period60Days
boolean
за замовчуванням:false
Для аналітики TikTok, коли встановлено true, повертає лише 60-денні агрегатні суми для коментарів, поширень і переглядів (commentCountTotal, shareCountTotal, viewCountTotal). Це забезпечує швидший час відповіді порівняно з отриманням повної історії аналітики. Примітка: не використовуйте цей параметр разом із daily=true, оскільки вони несумісні.Важливо: З 1 березня 2025 року TikTok перейшов на 60-денні суми. З квітня 2026 року TikTok використовує фільтрацію за датою на основі кварталів — використовуйте параметр quarters, щоб контролювати вікно дат (наприклад, quarters: 1 = 90 днів, quarters: 2 = 180 днів). Докладніше див. майбутні зміни.
youtube
object
Специфічні для платформи опції аналітики YouTube.lifetime (boolean, за замовчуванням: false): Коли встановлено true, включає lifetimeLikes у відповідь — суму лайків усіх публічних відео на каналі. Це обчислюється шляхом отримання всіх відео та підсумовування їх лайків, тому це може зайняти більше часу для каналів з великою кількістю відео.Поріг: Канали з понад 1 000 відео повертатимуть lifetimeLikes: null та попередження у масиві верхнього рівня warnings. Це запобігає надмірному використанню API.Кешування: Для кожного каналу, з коротшими TTL для неуспішних результатів, щоб повторні спроби швидко фіксували зміни стану:
  • Успішне значення lifetimeLikes: 24 години.
  • Bailout для 1 000 відео (попередження code: 445): 1 година — достатньо коротко, щоб канал, який видаляє відео, щоб опуститися нижче порога, не мав чекати повний день для реального значення.
  • Тимчасові збої YouTube Data API (попередження code: 446): не кешується — наступний запит повторює спробу.
Примітка: Видалені або приватні відео виключаються з суми, тому загальна кількість може відрізнятися від “справжньої” lifetime кількості лайків для каналів, які видалили відео.Приклад запиту:
userId
string
Лише X/Twitter. Цей параметр дозволяє отримувати пости від конкретного користувача X/Twitter за його числовим ID, а не з вашого підключеного облікового запису.Наприклад, щоб отримати всі пости від handle @Google, ви б використали їхній числовий userId 20536157.Ви можете знайти числовий userId будь-якого користувача X/Twitter, використавши endpoint Brands Get User.Примітка: використовуйте лише API KEY у заголовку для цього запиту. Не додавайте Profile Key.
userName
string
Лише X/Twitter. Цей параметр дозволяє отримувати пости від конкретного користувача X/Twitter за його handle, а не з вашого підключеного облікового запису.Наприклад, щоб отримати всі пости від handle @Google.Примітка: використовуйте лише API KEY у заголовку для цього запиту. Не додавайте Profile Key.
Коли кумулятивні метрики (наприклад, followers, likes) тимчасово недоступні з соціальної мережі, API автоматично backfill’ить їх зі збережених даних. Два необов’язкові поля можуть з’явитися в об’єкті analytics для платформи:
  • backfilledFrom (string, ISO 8601) — Присутнє, коли одна або кілька кумулятивних метрик було підставлено зі збережених даних. Часова мітка вказує, коли збережені дані було востаннє оновлено.
  • recoveredFrom (string, ISO 8601) — Присутнє, коли вся відповідь аналітики була відновлена зі збережених даних через повний збій API. Часова мітка вказує, коли збережені дані було востаннє оновлено.
Збережені дані старіші за 4 дні вважаються застарілими і не використовуватимуться для backfill або відновлення.LinkedIn reactions: Кумулятивна метрика reactions на рівні поста (об’єкт з підрахунками реакцій за типом) підпадає під цей backfill лише для порожніх значень. Коли LinkedIn застосовує rate-limit до отримання реакцій, значення переноситься з останнього успішного snapshot — а backfilledFrom встановлюється в часову мітку цього snapshot — замість того, щоб регресувати до порожнього.
Аналітика LinkedIn personal (member) — потрібне повторне підключення. Особисті профілі LinkedIn, підключені до випуску member analytics, не мають необхідних scopes аналітики. Запити соціальної аналітики для таких профілів повертають код помилки 475 (“re-link your LinkedIn profile to enable analytics”). Власник облікового запису має повторно підключити свій профіль LinkedIn на сторінці Social Accounts, щоб надати нові scopes. Дайте кілька хвилин після повторного підключення для очищення коду 475 (Ayrshare і LinkedIn коротко кешують стан дозволів, зазвичай ~5-10 хвилин). Публікація не зачіпається.
warnings (масив об’єктів, необов’язкове поле верхнього рівня) — Присутнє лише тоді, коли Ayrshare потрібно повідомити викликача про не-фатальну умову (наприклад, було пропущено opt-in обчислення). Відсутнє у відповіді, коли немає про що попереджати.Кожен запис — це структурований об’єкт, а не рядок вільної форми:Відомі коди попереджень:
  • 445lifetimeLikes пропущено, оскільки канал YouTube перевищує поріг 1 000 відео.
  • 446lifetimeLikes недоступний, оскільки YouTube Data API повернув помилки для playlist завантажень або кожного пакета videos.list.