Огляд Ayrshare API - Ayrshare API Documentation

Social Media REST API надає розробникам програмний доступ до кількох соцмереж через єдиний уніфікований інтерфейс. За допомогою соціального API Ayrshare ви можете керувати активністю в соцмережах — створювати й видаляти пости, отримувати аналітику, взаємодіяти з коментарями та відгуками, керувати прямими повідомленнями, створювати рекламу Facebook та виконувати інші соціальні дії на різних платформах. Наразі API підтримує 13 основних соцмереж: Bluesky, Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Telegram, Threads, TikTok, X (раніше Twitter) та YouTube. Інтегрувавшись із цим API, розробники можуть автоматизувати завдання керування соцмережами одночасно на всіх цих платформах. Дані запитів і відповідей API — у форматі JSON, що дозволяє легко парсити й обробляти їх у більшості мов програмування. Якщо ви на плані Launch, Business або Enterprise, див. Business Plan Overview, Launch Plan Overview та ендпоінт /profiles.

Ключова функціональність

Підтримка 13 соцмереж.
Захищений доступ до API за вашим унікальним API Key.
Заплановані публікації у підключених соцмережах.
Автоматична публікація за наперед визначеним розкладом.
Підтримка зображень та відеоконтенту, включно з Reels, Stories та Spotlight.
Видалення постів у підключених соцмережах.
Комплексна аналітика залученості (лайки, поширення тощо).
Метрики соціальних акаунтів, включно з кількістю підписників та демографічними даними.
Керування коментарями: перегляд, додавання та видалення коментарів до постів.
Опціональне скорочення посилань для всіх або конкретних URL у постах.
Інтеграція з Unsplash: додавайте конкретні зображення або обирайте випадкові за ключовими словами.
Опція автоматичної генерації хештегів на основі релевантних ключових слів.
Відстеження історії постів, включно з постами, зробленими не через Ayrshare.
Керування відгуками: отримання, відповіді та видалення відповідей на відгуки.
Інтеграція RSS-стрічок для автоматизованої публікації контенту.
Медіабібліотека: завантаження та зберігання фото й відео для використання у постах.
Social Post Verification System для безпеки ваших соціальних акаунтів.

Business Plan та Launch Plan

Можливості Business Plan та Launch Plan для керування кількома користувачами та клієнтами:

Дозвольте користувачам підключати власні акаунти соцмереж до вашої платформи.
Захищений єдиний вхід через OAuth для швидкого підключення акаунтів.
Створюйте та видаляйте User Profiles програмно через API.
Доступ до розширеної аналітики користувачів.
Підтримка webhooks для оновлень у реальному часі.
Керування прямими повідомленнями на підтримуваних платформах.
Створення реклами Facebook з наявних постів.

Зв’яжіться з нами, щоб дізнатися більше про Business Plan.

Ads API

Ads API дозволяє створювати рекламу Facebook з наявних постів.

Просування постів для охоплення більшої аудиторії.
Керування рекламою та відстеження ефективності.
Аналіз рекламних витрат та оптимізація кампаній.

Ads API

Досліджуйте Ads API

Messages API

Уніфікований Messaging API для залучення користувачів у розмови на основних соціальних каналах: Facebook, Instagram та X.

Надсилання текстових, графічних та відеоповідомлень.
Отримання повних історій розмов.
Налаштування автоматичних відповідей на повідомлення.
Отримання оновлень у реальному часі через webhooks про отримані повідомлення, реакції на повідомлення та підтвердження прочитання.

Цей API спрощує залучення користувачів, централізуючи операції з повідомленнями для кількох соціальних каналів. Дізнатися більше…

Messages API

Досліджуйте уніфікований messaging API

Max Pack

Отримайте ще більше можливостей із додатком Max Pack:

Max Pack

Розблокуйте розширені функції — генерацію контенту на базі AI, поглиблену аналітику та розширену підтримку платформ — з додатком Max Pack.

Якщо ви розробляєте на Node.js, перегляньте це відео про підключення та публікацію постів у X та Facebook.

Якщо ви користуєтеся Node.js, перегляньте демо-код Social API, щоб почати створювати власну інтеграцію.

Social API Demo

Досліджуйте наш демо-код на Node.js, щоб швидко розпочати інтеграцію Social API

Базовий URL

Базовий URL для Ayrshare API однаковий для всіх ендпоінтів. https://api.ayrshare.com/api

Authorization

Ayrshare автентифікує запити API за допомогою токена Authorization, що передається в HTTP-заголовку. Обов’язково надсилайте Bearer разом із API Key. API Key можна знайти в Ayrshare Dashboard, перемкнувшись на Primary Profile. Якщо ви користувач Business або Enterprise, можете створювати User Profiles з Profile Keys для керування кількома клієнтами. Profile Key використовується у заголовку ваших запитів. API Key також має бути у заголовку запитів для User Profiles.

На планах Premium у заголовку запитів має використовуватися лише API Key. На планах Business та Enterprise у заголовку запитів слід використовувати Profile Key, коли ви взаємодієте від імені User Profile.

Формат API Key

Authorization: Bearer API_KEY — замініть API_KEY на API Key вашого Primary Profile, який можна знайти в Ayrshare Dashboard.

curl -H "Authorization: Bearer API_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

$headers = ["Authorization" => "Bearer API_KEY"];

headers := map[string]string{"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

Отримайте секретний API Key на дашборді Ayrshare на сторінці API Key у лівій навігаційній панелі.Наприклад, якщо ваш API Key — 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAВаш заголовок має включати:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Формат Profile Key

Profile Key використовується для взаємодії від імені User Profile. Доступний лише на планах Business або Enterprise. Profile-Key: PROFILE_KEY — замініть PROFILE_KEY на Profile Key користувача. Включення Profile Key у заголовок необхідне для взаємодії від імені User Profile. Відсутність API Key Primary Profile або використання Profile Key замість API Key у заголовку призведе до помилки. Ось як структурувати заголовки для API-запитів:

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

Знайдіть Profile Key в Ayrshare Dashboard на сторінці Profile Key у лівій навігаційній панелі. Перемкніться на профіль, який хочете використовувати, на сторінці User Profile. Крім того, Profile Key повертається у відповіді ендпоінта Create a User Profile.Далі можна використовувати Profile Key у заголовку запитів:Наприклад, якщо ваш Profile Key — AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EAВаш заголовок має містити і API, і Profile Key:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

X/Twitter BYO Credentials

З 31 березня 2026 року всі операції X/Twitter через Ayrshare потребують ваших власних OAuth 1.0a-облікових даних. Після підключення X-акаунта через OAuth передавайте ці 2 заголовки разом з Authorization (та опціональним Profile-Key) для будь-якого запиту, спрямованого на X/Twitter:

Заголовок	Опис
`X-Twitter-OAuth1-Api-Key`	Ваш OAuth 1.0a API Key (Consumer Key)
`X-Twitter-OAuth1-Api-Secret`	Ваш OAuth 1.0a API Key Secret (Consumer Secret)

Ці заголовки обов’язкові після 31 березня 2026 року. Запити до ендпоінтів X/Twitter без валідних BYO-облікових даних будуть відхилені.

Одна пара ключів для кожного запиту. Ви створюєте один X Developer App на акаунт Ayrshare і використовуєте однакові значення X-Twitter-OAuth1-Api-Key та X-Twitter-OAuth1-Api-Secret у кожному запиті до X, незалежно від того, для якого субпрофіля (Profile-Key) призначено запит. Ключі не генеруються й не ротуються для кожного клієнта чи кінцевого користувача.

Див. Посібник із налаштування X BYO Key з покроковими інструкціями, прикладами коду та порадами з усунення несправностей. Ті ж два заголовки застосовуються при керуванні X/Twitter через MCP Server — див. Connect & Setup.

Content Type

Content Type завжди має бути Content-Type: "application/json", якщо ендпоінт спеціально не вказує інакше.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

Стиснення

Ayrshare підтримує стиснення для всіх API-запитів. Щоб увімкнути стиснення, встановіть заголовок Accept-Encoding у deflate, gzip, br.

  Accept-Encoding: "deflate, gzip, br"

Рекомендується для викликів з великими відповідями, наприклад ендпоінта /history.

Стискаються лише відповіді, більші за 1024 байти (1KB).
Порядок стиснення: спочатку Brotli (br), потім gzip, потім deflate. Brotli — найефективніший алгоритм стиснення.
Заголовок відповіді містить використане кодування контенту. Наприклад: content-encoding: br, якщо використано Brotli.
Дізнайтеся більше про стиснення та його переваги у блозі Ayrshare.

Не забудьте коректно розпакувати відповідь, використовуючи вказане кодування.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -H "Accept-Encoding: deflate, gzip, br" \ 
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json",
  "Accept-Encoding" => "deflate, gzip, br"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

Типи ID

Існує кілька типів ID, які повертаються та можуть використовуватися в різних ендпоінтах:

Ayrshare Post ID

Цей ID генерує Ayrshare, і він повертається з ендпоінта /post у полі id. З цим ID легко отримати аналітику посту в різних соцмережах, додавати коментарі до посту, видаляти пост тощо. Це ID, який ви будете використовувати найчастіше. Кожна соцмережа присвоює власний унікальний ID постам і коментарям. Ці ID повертаються у полі postIds ендпоінтів /post або /comments. Ви можете використовувати ці ID (або отримані безпосередньо із соцмереж) для отримання даних — наприклад, у analytics social post ID.

Ayrshare Comment ID

Цей ID генерує Ayrshare, і він повертається з ендпоінта /comments у полі id. З цим ID легко отримати аналітику коментаря в різних соцмережах, додавати відповіді до коментаря, видаляти коментар тощо. Це ID, який ви будете використовувати найчастіше. Часто застосовується, коли потрібні деталі конкретного коментаря, опублікованого через Ayrshare. Кожна соцмережа присвоює власний унікальний ID коментарям. Ці ID повертаються у полі commentId ендпоінта GET /comments. Часто застосовується, коли потрібні деталі конкретного коментаря, опублікованого поза межами Ayrshare.

Коди помилок

Помилки повертаються зі стандартними HTTP-кодами статусу. Докладніше:

HTTP Status Codes

Дізнайтеся більше про HTTP-коди статусу

Детальні помилки містяться у відповіді REST API — специфічні для кожного типу виклику. Докладніше:

Ayrshare Error Codes

Дізнайтеся більше про специфічні коди помилок Ayrshare

Формат часової мітки

Ayrshare використовує Zulu Time, також відомий як UTC (Coordinated Universal Time), або ISO 8601-форматований рядок дати для точних і однозначних посилань на час у різних часових поясах. Наприклад, використовуйте формат YYYY-MM-DDThh:mm:ssZ і надсилайте як 2026-07-08T12:30:00Z. Більше прикладів див. на utctime. Ви можете конвертувати UTC у місцевий час мовою програмування на ваш вибір. Наприклад, у JavaScript:

const convertToLocalTime = (isoString) => {
  // Create a new Date object from the ISO string
  const date = new Date(isoString);

  // Extract local time components
  const localDate = date.toLocaleDateString();
  const localTime = date.toLocaleTimeString();

  // Combine the local date and time
  const localDateTime = `${localDate} ${localTime}`;

  return localDateTime;
};

Postman

Ви можете використовувати Postman для тестування ваших REST API-викликів.

Postman

Дізнайтеся, як використовувати Postman з нашим API

Випадкові пости, зображення та відео

Перегляньте посібник швидкого старту про те, як надсилати випадкові пости, зображення або відео під час тестування.

Пакети

У нас є пакети Node.js і Python, а також посібники для Bubble.io, Airtable та Make, які спрощують виклики RESTful.

Node NPM Package

Інтегруйтеся з нашим пакетом NodeJS

Python PyPI Package

Інтегруйтеся з нашим пакетом Python

Airtable Guide

Дізнайтеся, як використовувати Ayrshare з Airtable

Bubble Plugin & Guide

Дізнайтеся, як використовувати Ayrshare з Bubble.io

Make Guide

Дізнайтеся, як використовувати Ayrshare з Make

Notion Guide

Дізнайтеся, як використовувати Ayrshare з Notion

FlutterFlow Guide

Дізнайтеся, як використовувати Ayrshare з FlutterFlow

Retool Guide

Дізнайтеся, як використовувати Ayrshare з Retool

​Ключова функціональність

​Business Plan та Launch Plan

​Ads API

Ads API

​Messages API

Messages API

​Max Pack

Max Pack

​Дивіться, як користуватися Social API

​Демо Social API

Social API Demo

​Базовий URL

​Authorization

​Формат API Key

​Формат Profile Key

​X/Twitter BYO Credentials

​Content Type

​Стиснення

​Типи ID

​Ayrshare Post ID

​Social Post ID

​Ayrshare Comment ID

​Social Comment ID

​Коди помилок

HTTP Status Codes

Ayrshare Error Codes

​Формат часової мітки

​Postman

Postman

​Випадкові пости, зображення та відео

​Пакети

Node NPM Package

Python PyPI Package

Airtable Guide

Bubble Plugin & Guide

Make Guide

Notion Guide

FlutterFlow Guide

Retool Guide

Ключова функціональність

Business Plan та Launch Plan

Ads API

Messages API

Max Pack

Дивіться, як користуватися Social API

Демо Social API

Базовий URL

Authorization

Формат API Key

Формат Profile Key

X/Twitter BYO Credentials

Content Type

Стиснення

Типи ID

Ayrshare Post ID

Social Post ID

Ayrshare Comment ID

Social Comment ID

Коди помилок

Формат часової мітки

Postman

Випадкові пости, зображення та відео

Пакети