REST APIGET

Points clés - 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 reseaux sociaux connectes a votre espace de travail. Utilisez les identifiants de connexion renvoyes lors de la creation de publications.

Cle API (jeton Bearer)

Permission:accounts.readRôles et permissions

Utilisation

Utilisez les valeurs id de cette reponse comme identifiants de connexion lors de la creation de publications. Par exemple, transmettez twitterConnectionIds avec l'id du compte Twitter. Les comptes de pages Facebook incluent egalement 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 reponses 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. Les discussions Telegram ne sont pas listées, car l'API ne peut pas publier sur Telegram.

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.

Cle 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.

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.

Cle API (jeton Bearer)

Permission:posts.draftRôles et permissions

Paramètres de requête

Parametre	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.

Cle 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 integrations

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>'

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