Vue d'ensemble de l'API Ayrshare - Ayrshare API Documentation

L’API REST de médias sociaux offre aux développeurs un accès programmatique à plusieurs réseaux sociaux via une interface unique et unifiée. Grâce à l’API sociale d’Ayrshare, vous pouvez gérer vos activités sur les réseaux sociaux, notamment créer et supprimer des publications, récupérer des statistiques, interagir avec les commentaires et les avis, gérer les messages directs, créer des publicités Facebook et effectuer d’autres actions liées aux réseaux sociaux, sur plusieurs plateformes. L’API prend actuellement en charge 13 grands réseaux sociaux : Bluesky, Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Telegram, Threads, TikTok, X (anciennement Twitter) et YouTube. En intégrant cette API, les développeurs peuvent automatiser simultanément les tâches de gestion des réseaux sociaux sur toutes ces plateformes. Les données de requête et de réponse de l’API sont au format JSON, ce qui permet une analyse et un traitement faciles dans la plupart des langages de programmation. Si vous êtes sur le Launch, Business ou Enterprise Plan, consultez la vue d’ensemble du Business Plan, la vue d’ensemble du Launch Plan et le point de terminaison /profiles.

Fonctionnalités clés

13 réseaux sociaux pris en charge.
Accès API sécurisé grâce à votre API Key unique.
Planification de publications sur les plateformes de réseaux sociaux connectées.
Publication automatisée selon des planifications prédéfinies.
Prise en charge des contenus image et vidéo, y compris Reels, Stories et Spotlight.
Suppression de publications sur les réseaux sociaux associés.
Statistiques complètes d’engagement des publications (mentions J’aime, partages, etc.).
Métriques des comptes sociaux, y compris le nombre d’abonnés et les données démographiques.
Gestion des commentaires : consulter, ajouter et supprimer des commentaires de publications.
Raccourcissement de liens facultatif pour toutes les URL ou pour des URL spécifiques dans les publications.
Intégration Unsplash : ajouter des images spécifiques ou en sélectionner aléatoirement à partir de mots-clés.
Option de génération automatique de hashtags à partir de mots-clés pertinents.
Suivi de l’historique des publications, y compris celles qui ne proviennent pas d’Ayrshare.
Gestion des avis : récupérer, répondre et supprimer les réponses aux avis.
Intégration de flux RSS pour la publication automatique de contenu.
Bibliothèque de médias : téléverser et stocker des photos et vidéos à utiliser dans les publications.
Social Post Verification System pour préserver la sécurité de vos comptes sociaux.

Business Plan et Launch Plan

Fonctionnalités du Business Plan et du Launch Plan pour gérer plusieurs utilisateurs et clients :

Permettre aux utilisateurs d’associer leurs propres comptes de réseaux sociaux à votre plateforme.
Authentification unique (SSO) sécurisée via OAuth pour une association rapide des comptes.
Créer et supprimer des User Profiles par programmation via l’API.
Accéder à des statistiques utilisateur avancées.
Prise en charge des webhooks pour des mises à jour en temps réel.
Gestion des messages directs sur les plateformes prises en charge.
Créer des publicités Facebook à partir de publications existantes.

Contactez-nous pour en savoir plus sur le Business Plan.

API Ads

L’API Ads vous permet de créer des publicités Facebook à partir de publications existantes.

Booster les publications pour toucher plus de personnes.
Gérer les publicités et suivre leurs performances.
Analyser les dépenses publicitaires et optimiser les campagnes.

API Ads

Explorez l’API Ads

API Messages

Une API de messagerie unifiée pour engager vos utilisateurs dans des conversations sur les principaux canaux de réseaux sociaux : Facebook, Instagram et X.

Envoi de messages texte, image et vidéo.
Récupération des historiques complets de conversations.
Configuration de réponses automatiques aux messages.
Réception de mises à jour en temps réel via webhooks pour les messages reçus, les réactions aux messages et les accusés de lecture.

Cette API simplifie l’engagement des utilisateurs en centralisant les opérations de messagerie pour plusieurs canaux de réseaux sociaux. En savoir plus…

API Messages

Explorez l’API de messagerie unifiée

Max Pack

Obtenez encore plus de fonctionnalités avec le module complémentaire Max Pack :

Max Pack

Débloquez des fonctionnalités avancées telles que la génération de contenu propulsée par l’IA, des statistiques enrichies et une prise en charge étendue des plateformes avec notre module Max Pack.

Découvrez comment utiliser l’API sociale

Si vous développez en Node.js, regardez cette vidéo qui explique comment se connecter et publier des posts sur X et Facebook.

Démo de l’API sociale

Si vous utilisez Node.js, consultez le code de démonstration de l’API sociale pour vous lancer dans la création de votre propre intégration.

Démo de l'API sociale

Explorez notre code de démo Node.js pour accélérer votre intégration à l’API sociale

URL de base

L’URL de base de l’API Ayrshare est identique pour tous les points de terminaison. https://api.ayrshare.com/api

Authorization

Ayrshare authentifie les requêtes API à l’aide d’un jeton Authorization transmis dans l’en-tête HTTP. Veillez à envoyer Bearer avec l’API Key. L’API Key se trouve dans le tableau de bord Ayrshare en basculant sur votre Primary Profile. Si vous êtes un utilisateur Business ou Enterprise, vous pouvez créer des User Profiles avec des Profile Keys pour gérer plusieurs clients. La Profile Key est utilisée dans l’en-tête de vos requêtes. L’API Key doit également être utilisée dans l’en-tête de vos requêtes pour les User Profiles.

Les plans Premium doivent utiliser uniquement l’API Key dans l’en-tête de leurs requêtes. Les plans Business et Enterprise doivent utiliser la Profile Key dans l’en-tête de leurs requêtes lorsqu’ils interagissent au nom d’un User Profile.

Format de l’API Key

Authorization: Bearer API_KEY en remplaçant API_KEY par l’API Key de votre Primary Profile, que vous trouverez dans le tableau de bord Ayrshare.

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"}

Obtenez votre API Key secrète dans le tableau de bord Ayrshare, sur la page API Key du panneau de navigation de gauche.Par exemple, si votre API Key est 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAVotre en-tête doit inclure :Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Format de la Profile Key

Une Profile Key est utilisée pour interagir au nom d’un User Profile. Elle n’est disponible que pour les plans Business ou Enterprise. Profile-Key: PROFILE_KEY en remplaçant PROFILE_KEY par la Profile Key d’un utilisateur. L’inclusion d’une Profile Key dans l’en-tête est requise pour interagir au nom d’un User Profile. Une API Key de Primary Profile manquante ou l’utilisation de la Profile Key à la place de l’API Key dans l’en-tête entraînera une erreur. Voici comment structurer les en-têtes pour les requêtes 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"
}

Trouvez la Profile Key dans le tableau de bord Ayrshare, sur la page Profile Key du panneau de navigation de gauche. Basculez vers le profil que vous souhaitez utiliser dans la page User Profile. De plus, la Profile Key est renvoyée dans la réponse du point de terminaison Create a User Profile.Vous pouvez ensuite utiliser la Profile Key dans l’en-tête de vos requêtes :Par exemple, si votre Profile Key est AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EAVotre en-tête doit inclure à la fois l’API Key et la Profile Key :Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

Identifiants BYO X/Twitter

À partir du 31 mars 2026, toutes les opérations X/Twitter via Ayrshare nécessitent vos propres identifiants OAuth 1.0a. Après avoir associé votre compte X via OAuth, transmettez ces 2 en-têtes en complément de vos en-têtes Authorization (et Profile-Key optionnel) pour toute requête ciblant X/Twitter :

En-tête	Description
`X-Twitter-OAuth1-Api-Key`	Votre API Key OAuth 1.0a (Consumer Key)
`X-Twitter-OAuth1-Api-Secret`	Votre secret d’API Key OAuth 1.0a (Consumer Secret)

Ces en-têtes sont obligatoires après le 31 mars 2026. Les requêtes vers les points de terminaison X/Twitter dépourvues d’identifiants BYO valides seront rejetées.

Une seule paire de clés, utilisée pour chaque requête. Vous créez une seule X Developer App par compte Ayrshare et utilisez les mêmes valeurs X-Twitter-OAuth1-Api-Key et X-Twitter-OAuth1-Api-Secret pour chaque requête ciblant X, quel que soit le sous-profil (Profile-Key) concerné par la requête. Vous ne générez ni ne renouvelez pas les clés par client ou par utilisateur final.

Consultez le guide de configuration des clés BYO pour X pour des instructions pas à pas, des exemples de code et des conseils de dépannage. Les deux mêmes en-têtes s’appliquent lorsque vous pilotez X/Twitter via le MCP Server — voir Connect & Setup.

Content Type

Le Content Type doit toujours être défini sur Content-Type: "application/json", sauf indication contraire du point de terminaison.

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"
}

Compression

Ayrshare prend en charge la compression pour toutes les requêtes API. Pour activer la compression, définissez l’en-tête Accept-Encoding sur deflate, gzip, br.

  Accept-Encoding: "deflate, gzip, br"

Ceci est recommandé pour les appels retournant des réponses volumineuses, comme le point de terminaison /history.

Seules les réponses dépassant 1024 octets (1 Ko) sont compressées.
Ordre de compression utilisé : Brotli (br) en premier, puis gzip, puis deflate. Brotli est l’algorithme de compression le plus efficace.
L’en-tête de réponse contient l’encodage de contenu utilisé. Par exemple : content-encoding: br si Brotli a été utilisé.
Découvrez la compression et ses avantages sur le blog Ayrshare.

N’oubliez pas de décompresser correctement la réponse en utilisant l’encodage de contenu.

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"
}

Types d’ID

Plusieurs types d’ID sont renvoyés et peuvent être utilisés dans différents points de terminaison :

Ayrshare Post ID

Cet ID est généré par Ayrshare et renvoyé par le point de terminaison /post dans le champ id. Cet ID facilite la récupération des statistiques de la publication sur les réseaux sociaux, l’ajout de commentaires à la publication, la suppression de la publication, etc. C’est l’ID que vous utiliserez le plus souvent. Chaque réseau social attribue son propre ID unique aux publications et aux commentaires. Ces ID sont renvoyés dans le champ postIds des points de terminaison /post ou /comments. Vous pouvez utiliser ces ID, ou ceux que vous obtenez directement auprès des réseaux sociaux, pour récupérer des données, comme avec l’ID de publication sociale des analytics.

Ayrshare Comment ID

Cet ID est généré par Ayrshare et renvoyé par le point de terminaison /comments dans le champ id. Cet ID facilite la récupération des statistiques du commentaire sur les réseaux sociaux, l’ajout de réponses au commentaire, la suppression du commentaire, etc. C’est l’ID que vous utiliserez le plus souvent. Il est souvent utilisé lorsque vous souhaitez obtenir des détails sur un commentaire spécifique publié via Ayrshare. Chaque réseau social attribue son propre ID unique aux commentaires. Ces ID sont renvoyés dans le champ commentId du point de terminaison GET /comments. Il est souvent utilisé lorsque vous souhaitez obtenir des détails sur un commentaire spécifique publié en dehors d’Ayrshare.

Codes d’erreur

Les erreurs sont renvoyées avec les codes de statut HTTP standard. Pour plus d’informations :

Codes de statut HTTP

En savoir plus sur les codes de statut HTTP

Les erreurs détaillées figurent dans la réponse de l’API REST spécifique à chaque type d’appel. Pour plus d’informations :

Codes d'erreur Ayrshare

En savoir plus sur les codes d’erreur spécifiques à Ayrshare

Format d’horodatage

Ayrshare utilise l’heure Zulu, également connue sous le nom d’UTC (Temps universel coordonné), ou une chaîne de date formatée selon la norme ISO 8601, pour des références temporelles précises et sans ambiguïté entre les différents fuseaux horaires. Par exemple, utilisez le format YYYY-MM-DDThh:mm:ssZ et envoyez 2026-07-08T12:30:00Z. Consultez utctime pour plus d’exemples. Vous pouvez convertir le format UTC en heure locale dans le langage de programmation de votre choix. Par exemple en 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

Vous pouvez utiliser Postman pour tester vos appels d’API REST.

Postman

Découvrez comment utiliser Postman avec notre API

Publications, images et vidéos aléatoires

Consultez le guide de démarrage rapide pour savoir comment envoyer des publications, images ou vidéos aléatoires lors de vos tests.

Packages

Nous proposons des packages Node.js et Python, ainsi que des guides Bubble.io, Airtable et Make pour faciliter les appels RESTful.

Package Node NPM

Intégrez à l’aide de notre package NodeJS

Package Python PyPI

Intégrez à l’aide de notre package Python

Guide Airtable

Découvrez comment utiliser Ayrshare avec Airtable

Plugin et guide Bubble

Découvrez comment utiliser Ayrshare avec Bubble.io

Guide Make

Découvrez comment utiliser Ayrshare avec Make

Guide Notion

Découvrez comment utiliser Ayrshare avec Notion

Guide FlutterFlow

Découvrez comment utiliser Ayrshare avec FlutterFlow

Guide Retool

Découvrez comment utiliser Ayrshare avec Retool

​Fonctionnalités clés

​Business Plan et Launch Plan

​API Ads

API Ads

​API Messages

API Messages

​Max Pack

Max Pack

​Découvrez comment utiliser l’API sociale

​Démo de l’API sociale

Démo de l'API sociale

​URL de base

​Authorization

​Format de l’API Key

​Format de la Profile Key

​Identifiants BYO X/Twitter

​Content Type

​Compression

​Types d’ID

​Ayrshare Post ID

​Social Post ID

​Ayrshare Comment ID

​Social Comment ID

​Codes d’erreur

Codes de statut HTTP

Codes d'erreur Ayrshare

​Format d’horodatage

​Postman

Postman

​Publications, images et vidéos aléatoires

​Packages

Package Node NPM

Package Python PyPI

Guide Airtable

Plugin et guide Bubble

Guide Make

Guide Notion

Guide FlutterFlow

Guide Retool

Fonctionnalités clés

Business Plan et Launch Plan

API Ads

API Messages

Max Pack

Découvrez comment utiliser l’API sociale

Démo de l’API sociale

URL de base

Authorization

Format de l’API Key

Format de la Profile Key

Identifiants BYO X/Twitter

Content Type

Compression

Types d’ID

Ayrshare Post ID

Social Post ID

Ayrshare Comment ID

Social Comment ID

Codes d’erreur

Format d’horodatage

Postman

Publications, images et vidéos aléatoires

Packages