Skip to main content
GET
Цей ендпоінт повертає детальну інформацію про автентифікованого користувача або user profile, зокрема:
  • Повний перелік усіх підключених акаунтів соцмереж
  • Імена користувачів у соцмережах та інформацію профілів
  • Статус акаунта та метрики використання
Дані, що повертаються, відображають стан підключених соцмереж станом на момент останнього оновлення і оновлюються щоразу, коли користувачі підключають чи від’єднують свої соціальні акаунти.
Кешування відповідей. Відповіді кешуються на строк до 60 секунд. Поля lastUpdated і nextUpdate описують це вікно кешу: lastUpdated — це час, коли було створено знімок, nextUpdate — час, коли він закінчиться.nextUpdate — це маркер закінчення кешу, а не сигнал готовності. Він проставляється в кожній відповіді, зокрема в тій, у якій displayNames ще не містить акаунта, про який вас щойно сповістили, тому він не може повідомити, коли щойно підключений акаунт завершив поширення.Якщо ви узгоджуєте social webhook для щойно створеного підключення, опитуйте, доки очікуваний акаунт не з’явиться у displayNames — не сприймайте одну відповідь чи появу nextUpdate як підтвердження того, що підключення відсутнє або завершене.
username і displayName у Threads. У записі Threads у displayNames поле username — це хендл акаунта (наприклад, ayrshare). displayName — це ім’я, яке показано в профілі (наприклад, Ayrshare). Вони можуть відрізнятися, тому використовуйте username або profileUrl, щоб знайти акаунт Threads.
Якщо жодного соціального акаунта не підключено, поле activeSocialAccounts не повертається. Отримайте дані для конкретного User Profile, додавши Profile-Key у заголовок.
  • Якщо вашому бізнесу потрібно одразу зібрати всі дані user profile, використовуйте ендпоінт /user/batch.
  • Якщо потрібне сповіщення, коли користувач підключає та від’єднує соціальний акаунт, див. ендпоінт /webhooks.

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

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

boolean
за замовчуванням:false
Повертає додаткові деталі Instagram — тип акаунта (business або creator) та використану квоту. Не рекомендується, якщо ці додаткові дані не потрібні, оскільки це сповільнює відповідь.

Місячна квота публікацій

Відповідь показує, яку частину місячної квоти публікацій профілю вже використано:
  • monthlyPostCount: публікації, зараховані до квоти цього місяця.
  • monthlyPostQuota: місячний ліміт. Поле не повертається, коли квота становить 10 000 або більше, наприклад на планах Business. Ліміт однаково діє.
Лічильник скидається 1-го числа кожного місяця о 00:07 UTC, а не в дату вашого платежу. Невдалі спроби публікації теж зараховуються. monthlyApiCalls — це інший лічильник, і це не квота публікацій. Що зараховується і що відбувається, коли квоту вичерпано, див. у статті Скільки публікацій та API-викликів я можу зробити?.