REST APIGET

Social-Media-Profile-API

Rufen Sie alle mit Ihrem AdaptlyPost-Workspace verbundenen Social-Media-Konten samt Plattform, ID und Verbindungsstatus ab.

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

Gibt eine Liste aller Social-Media-Konten zurück, die mit Ihrem Workspace verbunden sind. Verwenden Sie die zurückgegebenen Verbindungs-IDs beim Erstellen von Beiträgen.

API-Schlüssel (Bearer-Token)

Berechtigung:accounts.readRollen und Berechtigungen

Verwendung

Verwenden Sie die id-Werte aus dieser Antwort als Verbindungs-IDs beim Erstellen von Beiträgen. Übergeben Sie beispielsweise twitterConnectionIds mit der id des Twitter-Kontos. Facebook-Seitenkonten enthalten zusätzlich eine pageId (die Facebook-Seiten-ID), da Seiten keinen username haben. Für Facebook akzeptiert pageIds entweder die Konto-id oder die pageId, und Beitragsantworten geben immer die Facebook-pageId zurück. Jedes Konto trägt außerdem einen status: active oder unauthorized, wenn die Plattform das Token abgelehnt hat. Beiträge an ein nicht autorisiertes Konto werden mit 400 abgelehnt, bis es im Dashboard neu verbunden wird; unauthorizedReason enthält die Meldung der Plattform.

Ein Standort im Google Unternehmensprofil hat den Standortnamen als displayName und einen leeren username. Instagram-Konten haben supportsInstagramAudio, true, wenn das Konto über Facebook verbunden wurde. Das ist nötig, um einem Reel Audio hinzuzufügen. Ein Telegram-Kanal oder eine Telegram-Gruppe hat den Chattitel als displayName, den öffentlichen @username ohne @ als username (leer, wenn der Chat keinen hat) und eine leere avatarUrl. Ein Chat, aus dem der AdaptlyPost-Bot entfernt wurde, erscheint als unauthorized.

Ein Konto erneut prüfen

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

Seiten werden automatisch zweimal täglich bei Facebook geprüft. Um eine Seite sofort zu prüfen, rufen Sie diesen Endpunkt mit der Konto-id oder der Facebook-pageId auf. Ein abgelehntes Token markiert die Seite als unauthorized und löst account.unauthorized aus; ein funktionierendes Token hebt eine frühere Markierung auf. Die Antwort enthält den aktuellen status.

API-Schlüssel (Bearer-Token)

Berechtigung:accounts.manageRollen und Berechtigungen

Nur ein Admin-Schlüssel hält accounts.manage. Konten verbinden, trennen und erneut prüfen, Seiten und Boards wählen, Pinterest-Einstellungen und Connect-Links sind nur für Admins.

Ein Konto entfernen

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

Trennt das Konto vom Workspace, genau wie das Trennen auf der Seite Connectors. Die gespeicherten Tokens werden gelöscht, das Konto wird aus allen ausstehenden und wiederkehrenden Beiträgen entfernt und zählt nicht mehr für Ihren Tarif. Übergeben Sie die Konto-id oder die Facebook-pageId. Es funktioniert unabhängig vom status des Kontos, sodass Sie ein Konto mit unauthorized entfernen können, ohne es neu zu verbinden. Die Antwort enthält id, platform, displayName und bei Facebook die pageId des entfernten Kontos mit removed: true. Eine id, die der Workspace nicht hat, ergibt 404.

API-Schlüssel (Bearer-Token)

Berechtigung:accounts.manageRollen und Berechtigungen

Nur ein Admin-Schlüssel hält accounts.manage. Konten verbinden, trennen und erneut prüfen, Seiten und Boards wählen, Pinterest-Einstellungen und Connect-Links sind nur für Admins.

Bei Facebook wird nur die genannte Seite entfernt; andere Seiten, die über dasselbe Facebook-Login verbunden sind, bleiben. Wenn Sie einen YouTube-Kanal entfernen, werden auch seine Backup-Uploads beendet. Wenn Sie einen Telegram-Kanal oder eine Telegram-Gruppe entfernen, wird dort nicht mehr gepostet, aber der Bot bleibt im Chat, bis Sie ihn in Telegram entfernen. Um ein Konto zurückzuholen, verbinden Sie es erneut.

Instagram-Audio suchen

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

Sucht Instagram-Musik und Originalaudios für ein Reel. Lassen Sie searchQuery weg, um aktuelle Trends zu erhalten, und übergeben Sie die gewählte audioId in instagramConfigs[].audio. Funktioniert nur für Instagram-Konten mit supportsInstagramAudio: true.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.draftRollen und Berechtigungen

Query-Parameter

Parameter	Typ	Beschreibung
`audioType`ERFORDERLICH	`string`	music oder original_sound
`searchQuery`	`string`	Stichwortfilter, bis zu 100 Zeichen. Weglassen für aktuelle Trends

Audio-Felder

Feld	Beschreibung
`audioId`	Übergeben Sie sie als instagramConfigs[].audio.audioId
`audioType`	music oder original_sound
`title`	Der Titel des Tracks
`displayArtist, igUsername`	displayArtist bei Musik, igUsername (das Instagram-Handle der Person, die es erstellt hat) bei einem Originalaudio
`durationMs`	Länge in Millisekunden
`coverArtworkUrl, profilePictureUrl`	Cover bei Musik, Profilbild der Person, die es erstellt hat, bei einem Originalaudio
`previewUrl`	Ein temporärer Link zur Audiodatei, um eine Vorschau abzuspielen. Er läuft nach etwa 1,5 Tagen ab
`instagramUrl`	Die Seite des Audios auf Instagram
`isAdsEligible`	Ob Instagram das Audio als in Anzeigen nutzbar markiert

Die Liste enthält nur Audio, das Meta für die Veröffentlichung aus anderen Apps freigegeben hat. Das kann von der Instagram-App abweichen. Ein nicht über Facebook verbundenes Konto oder eine von Instagram abgelehnte Suche ergibt 400. Eine unbekannte Konto-ID ergibt 404.

Pinterest-Boards auflisten

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

Gibt in boards jedes Board zurück, auf das ein Pinterest-Konto pinnen kann, geheime Boards eingeschlossen. Übergeben Sie die id eines Boards als pinterestConfigs[].boardId oder seinen Namen als pinterestConfigs[].boardName. Ein Board gehört zu genau einem Pinterest-Konto. Listen Sie deshalb die Boards jedes Kontos auf, auf dem Sie posten.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.draftRollen und Berechtigungen

Board-Felder

Feld	Beschreibung
`id`	Übergeben Sie sie als pinterestConfigs[].boardId
`name`	Der Name des Boards. Sie können ihn als pinterestConfigs[].boardName übergeben
`description`	Die Beschreibung des Boards. Optional
`privacy`	PUBLIC, PROTECTED oder SECRET, wie Pinterest es meldet. Optional
`pinCount`	Anzahl der Pins auf dem Board. Optional

Eine Konto-ID, die nicht existiert oder in diesem Workspace kein Pinterest-Konto ist, ergibt 404. Eine Anfrage, die Pinterest ablehnt, ergibt 400, meist weil das Konto neu verbunden werden muss.

Alle Integrationen auflisten

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

Eine Facebook-Seite jetzt prüfen

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

Ein Konto entfernen

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

Instagram-Audio suchen

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

Pinterest-Boards auflisten

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