REST APIGET

API des comptes sociaux

Récupérez tous les comptes de réseaux sociaux connectés à votre espace AdaptlyPost, avec plateforme, ID et statut.

GEThttps://post.adaptlypost.com/post/api/v1/social-accounts

Renvoie la liste de tous les comptes de réseaux sociaux connectés à votre espace de travail. Utilisez les identifiants de connexion renvoyés lors de la création de publications.

Clé API (jeton Bearer)

Permission:accounts.readRôles et permissions

Utilisation

Utilisez les valeurs id de cette réponse comme identifiants de connexion lors de la création de publications. Par exemple, transmettez twitterConnectionIds avec l'id du compte Twitter. Les comptes de pages Facebook incluent également un pageId (l'identifiant de la page Facebook), car les pages n'ont pas de username. Pour Facebook, pageIds accepte soit l'id du compte, soit le pageId, et les réponses des publications renvoient toujours le pageId Facebook. Chaque compte porte aussi un status : active, ou unauthorized lorsque la plateforme a rejeté son jeton. Les publications vers un compte non autorisé sont refusées avec un 400 jusqu'à sa reconnexion dans le tableau de bord, et unauthorizedReason contient le message de la plateforme.

Un établissement de la fiche Google a son nom comme displayName et un username vide. Les comptes Instagram portent supportsInstagramAudio, true quand le compte a été connecté via Facebook, ce qu'exige l'ajout d'un audio à un Reel. Un canal ou un groupe Telegram a le titre de la discussion comme displayName, son @username public sans le @ comme username (vide si la discussion n'en a pas) et un avatarUrl vide. Une discussion dont le bot AdaptlyPost a été retiré apparaît comme unauthorized.

Revérifier un compte

POSThttps://post.adaptlypost.com/post/api/v1/social-accounts/:id/check

Les pages sont vérifiées auprès de Facebook automatiquement deux fois par jour. Pour en vérifier une maintenant, appelez ce point de terminaison avec l'id du compte ou le pageId Facebook. Un jeton rejeté marque la page unauthorized et déclenche account.unauthorized ; un jeton valide efface une marque antérieure. La réponse contient le status à jour.

Clé API (jeton Bearer)

Permission:accounts.manageRôles et permissions

Seule une clé Administrateur détient accounts.manage. Connecter, déconnecter et revérifier les comptes, choisir les pages et les tableaux, les préférences Pinterest et les liens de connexion sont réservés aux Administrateurs.

Supprimer un compte

DELETEhttps://post.adaptlypost.com/post/api/v1/social-accounts/:id

Déconnecte le compte du workspace, comme le faire depuis la page Connectors. Ses jetons enregistrés sont supprimés, il est retiré de toutes les publications en attente et récurrentes, et il ne compte plus dans votre forfait. Passez l'id du compte ou le pageId Facebook. Cela fonctionne quel que soit le status du compte, vous pouvez donc nettoyer un compte unauthorized sans le reconnecter. La réponse renvoie l'id, platform, displayName et, pour Facebook, le pageId du compte supprimé avec removed: true. Un id que le workspace ne possède pas renvoie 404.

Clé API (jeton Bearer)

Permission:accounts.manageRôles et permissions

Pour Facebook, seule la page indiquée est supprimée ; les autres pages connectées avec la même connexion Facebook restent. Supprimer une chaîne YouTube arrête aussi ses envois de secours. Supprimer un canal ou un groupe Telegram arrête les publications, mais le bot reste dans la discussion jusqu'à ce que vous le retiriez dans Telegram. Pour récupérer un compte, reconnectez-le.

Rechercher un audio Instagram

GEThttps://post.adaptlypost.com/post/api/v1/social-accounts/:id/instagram-audio

Recherche des musiques et des sons originaux Instagram à ajouter à un Reel. Omettez searchQuery pour obtenir les tendances, puis passez l'audioId choisi dans instagramConfigs[].audio. Fonctionne uniquement pour les comptes Instagram avec supportsInstagramAudio: true.

Clé API (jeton Bearer)

Permission:posts.draftRôles et permissions

Paramètres de requête

Paramètre	Taper	Description
`audioType`REQUIS	`string`	music ou original_sound
`searchQuery`	`string`	Filtre par mot-clé, jusqu’à 100 caractères. Omettez-le pour les audios tendance

Champs de l’audio

Champ	Description
`audioId`	Passez-le dans instagramConfigs[].audio.audioId
`audioType`	music ou original_sound
`title`	Le titre du morceau
`displayArtist, igUsername`	displayArtist pour une musique, igUsername (le compte Instagram de la personne qui l’a créé) pour un son original
`durationMs`	Durée en millisecondes
`coverArtworkUrl, profilePictureUrl`	Pochette pour une musique, photo de profil de la personne qui l’a créé pour un son original
`previewUrl`	Un lien temporaire vers le fichier audio, pour écouter un aperçu. Il expire au bout d’environ 1,5 jour
`instagramUrl`	La page de l’audio sur Instagram
`isAdsEligible`	Indique si Instagram autorise l’audio dans les publicités

La liste ne contient que les audios que Meta autorise pour la publication depuis d'autres apps, ce qui peut différer de l'app Instagram. Un compte non connecté via Facebook, ou une recherche refusée par Instagram, renvoie 400. Un id de compte inconnu renvoie 404.

Lister les tableaux Pinterest

GEThttps://post.adaptlypost.com/post/api/v1/social-accounts/:id/pinterest-boards

Renvoie dans boards tous les tableaux sur lesquels un compte Pinterest peut épingler, tableaux secrets compris. Passez l'id d'un tableau dans pinterestConfigs[].boardId, ou son nom dans pinterestConfigs[].boardName. Un tableau appartient à un seul compte Pinterest, listez donc les tableaux de chaque compte sur lequel vous publiez.

Clé API (jeton Bearer)

Permission:posts.draftRôles et permissions

Champs du tableau

Champ	Description
`id`	Passez-le dans pinterestConfigs[].boardId
`name`	Le nom du tableau. Vous pouvez le passer dans pinterestConfigs[].boardName
`description`	La description du tableau. Facultatif
`privacy`	PUBLIC, PROTECTED ou SECRET, tel que Pinterest l'indique. Facultatif
`pinCount`	Nombre d'épingles du tableau. Facultatif

Un id de compte qui n'existe pas, ou qui n'est pas un compte Pinterest de cet espace de travail, renvoie 404. Une requête que Pinterest refuse renvoie 400, le plus souvent parce que le compte doit être reconnecté.

Lister toutes les intégrations

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts \
  --header 'Authorization: Bearer <api-key>'

Vérifier une page Facebook maintenant

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/check \
  --header 'Authorization: Bearer <api-key>'

Supprimer un compte

curl --request DELETE \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id> \
  --header 'Authorization: Bearer <api-key>'

Rechercher un audio Instagram

curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/instagram-audio?audioType=music&searchQuery=summer' \
  --header 'Authorization: Bearer <api-key>'

Lister les tableaux Pinterest

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/pinterest-boards \
  --header 'Authorization: Bearer <api-key>'

200

{
  "accounts": [
    {
      "id": "conn_abc123",
      "platform": "TWITTER",
      "displayName": "Your Handle",
      "username": "@yourhandle",
      "avatarUrl": "https://pbs.twimg.com/profile_images/...",
      "status": "active"
    },
    {
      "id": "conn_def456",
      "platform": "LINKEDIN",
      "displayName": "Your Company",
      "username": "",
      "avatarUrl": "https://media.licdn.com/...",
      "status": "active"
    },
    {
      "id": "conn_ghi789",
      "platform": "INSTAGRAM",
      "displayName": "Your Profile",
      "username": "yourprofile",
      "avatarUrl": "https://scontent.cdninstagram.com/...",
      "status": "active",
      "supportsInstagramAudio": true
    },
    {
      "id": "conn_pqr678",
      "platform": "TELEGRAM",
      "displayName": "Your Channel",
      "username": "yourchannel",
      "avatarUrl": "",
      "status": "active"
    },
    {
      "id": "conn_mno345",
      "platform": "GOOGLE_BUSINESS",
      "displayName": "Your Cafe, Main Street",
      "username": "",
      "avatarUrl": "",
      "status": "active"
    },
    {
      "id": "conn_jkl012",
      "platform": "FACEBOOK",
      "displayName": "Your Page",
      "username": "",
      "avatarUrl": "",
      "status": "unauthorized",
      "unauthorizedReason": "This Page access token belongs to a Page that is not accessible.",
      "pageId": "123456789012345"
    }
  ]
}