REST APIPOST

Massenplanung

Planen Sie bis zu 100 Social-Media-Beiträge gleichzeitig mit plattformspezifischen Einstellungen über die AdaptlyPost API.

POSThttps://post.adaptlypost.com/post/api/v1/social-posts/bulk

Planen Sie bis zu 100 Beiträge gleichzeitig. Jeder Beitrag kann eigene Inhalte, Medien und eine geplante Zeit haben, während dieselben Plattformverbindungen geteilt werden.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.scheduleRollen und Berechtigungen

posts.schedule, wenn jedes Element ein zukünftiges scheduledAt hat. Liegt ein Element in der Gegenwart oder Vergangenheit, wird es sofort veröffentlicht, und der Schlüssel braucht zusätzlich posts.publish. Mitwirkenden- und Betrachter-Schlüssel können keine Massenplanung nutzen.

Body-Parameter

Parameter	Typ	Beschreibung
`platforms`ERFORDERLICH	`PlatformType[]`	Zielplattformen für alle Beiträge
`timezone`ERFORDERLICH	`string`	IANA-Zeitzone für die Planung
`posts`ERFORDERLICH	`PostItem[]`	Array von zu planenden Beiträgen (1-100)
`twitterConnectionIds`	`string[]`	Twitter-Konto-Verbindungs-IDs
`linkedinConnectionIds`	`string[]`	LinkedIn-Konto-Verbindungs-IDs
`instagramConnectionIds`	`string[]`	Instagram-Konto-Verbindungs-IDs
`tiktokConnectionIds`	`string[]`	TikTok-Konto-Verbindungs-IDs
`youtubeConnectionIds`	`string[]`	YouTube-Kanal-Verbindungs-IDs
`pinterestConnectionIds`	`string[]`	Pinterest-Konto-Verbindungs-IDs
`blueskyConnectionIds`	`string[]`	Bluesky-Konto-Verbindungs-IDs
`mastodonConnectionIds`	`string[]`	Mastodon-Konto-Verbindungs-IDs
`googleBusinessConnectionIds`	`string[]`	Verbindungs-IDs der Standorte im Google Unternehmensprofil
`tumblrConnectionIds`	`string[]`	Verbindungs-IDs der Tumblr-Blogs
`telegramConnectionIds`	`string[]`	Verbindungs-IDs der Telegram-Kanäle und -Gruppen
`threadsConnectionIds`	`string[]`	Threads-Konto-Verbindungs-IDs
`pageIds`	`string[]`	Facebook-Seiten, auf denen gepostet wird. Akzeptiert entweder die Konto-id oder die pageId aus /social-accounts
`pinterestConfigs`	`PinterestConfig[]`	Pinterest-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
`tiktokConfigs`	`TikTokConfig[]`	TikTok-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
`instagramConfigs`	`InstagramConfig[]`	Instagram-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
`facebookConfigs`	`FacebookConfig[]`	Facebook-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
`youtubeConfigs`	`YouTubeConfig[]`	YouTube-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
`googleBusinessConfigs`	`GoogleBusinessConfig[]`	Einstellungen für das Google Unternehmensprofil auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
`tumblrConfigs`	`TumblrConfig[]`	Tumblr-Einstellungen auf Batch-Ebene, die für alle Beiträge gelten. Schema unter Plattform-Konfigurationen

Beitragselement-Felder

Jeder Beitrag im Array kann eigene Inhalte, Medien und eine eigene Veröffentlichungszeit haben.

Parameter für Beitragselemente

Parameter	Typ	Beschreibung
`contentType`ERFORDERLICH	`ContentType`	Inhaltstyp (erforderlich)
`text`	`string`	Textinhalt des Beitrags. Auf LinkedIn erwähnen Sie eine Unternehmensseite mit @[Seitenname](urn:li:organization:<id>), wobei der Name genau so geschrieben sein muss, wie LinkedIn ihn anzeigt. LinkedIn erlaubt nur Erwähnungen von Unternehmensseiten, nicht von Personen
`platformTexts`	`PlatformText[]`	Textspezifische Überschreibungen pro Plattform
`mediaUrls`	`string[]`	URLs der Mediendateien
`mediaAltTexts`	`string[]`	Alternativtext für jedes Bild, in derselben Reihenfolge wie mediaUrls. Höchstens 1000 Zeichen pro Eintrag; ein leerer String überspringt ein Bild. Wird an X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram und Threads gesendet. Pinterest verwendet den ersten, gekürzt auf 500 Zeichen. TikTok, YouTube, das Google Unternehmensprofil und Videos ignorieren ihn.
`thumbnailUrl`	`string`	Thumbnail-URL für Videobeiträge
`thumbnailTimestampMs`	`number`	Videobild, das als Vorschaubild dient, in Millisekunden ab Beginn
`platformThumbnails`	`PlatformThumbnail[]`	Ein anderes Thumbnail für eine Plattform eines Videobeitrags, als { platform, thumbnailUrl?, thumbnailTimestampMs? }. YOUTUBE, FACEBOOK, LINKEDIN und TELEGRAM nehmen ein Bild, INSTAGRAM und PINTEREST ein Bild oder ein Videobild, TIKTOK nur ein Videobild. Plattformen ohne Eintrag nutzen thumbnailUrl und thumbnailTimestampMs
`platformAspectRatios`	`PlatformAspectRatio[]`	Bringt jedes Bild eines IMAGE- oder CAROUSEL-Beitrags auf einer Plattform in ein Format, als { platform, aspectRatio, fit? }. aspectRatio ist SQUARE, PORTRAIT, VERTICAL oder LANDSCAPE: INSTAGRAM nimmt SQUARE, PORTRAIT oder LANDSCAPE, TIKTOK alle vier. fit ist CROP (Standard) oder PAD. Siehe Beitrag erstellen
`firstComments`	`PlatformFirstComment[]`	Ein Kommentar, der vom selben Konto unter dem veröffentlichten Beitrag gepostet wird, als { platform, text }. Ein Eintrag pro Plattform. LINKEDIN nimmt bis zu 1250 Zeichen, TWITTER 280, THREADS 500, BLUESKY 300, MASTODON 500, YOUTUBE 10000 (nicht bei privaten oder für Kinder gemachten Videos), FACEBOOK 8000 und INSTAGRAM 2200 (nicht bei Stories). Andere Plattformen ergeben einen 400. Eine Facebook-Seite oder ein Instagram-Konto, das vor der Einführung erster Kommentare dort verbunden wurde, muss einmal neu verbunden werden; bis dahin schlägt der Kommentar mit firstCommentError fehl
`threadReplies`	`PlatformThreadReplies[]`	Macht den Beitrag zu einem Thread, als { platform, texts }: Der Beitrag eröffnet ihn, und jeder Text geht vom selben Konto als Antwort auf den vorherigen raus. Ein Eintrag pro Plattform, bis zu 25 Texte. TWITTER nimmt 280 Zeichen pro Antwort (mehr mit X Premium), THREADS 500, BLUESKY 300 und MASTODON 500 (oder das Limit der Instanz). Andere Plattformen, eine leere oder zu lange Antwort und eine Plattform, die auch einen ersten Kommentar hat, ergeben einen 400
`scheduledAt`ERFORDERLICH	`string`	Planungsdatum (erforderlich, ISO 8601)
`pinterestConfigs`	`PinterestConfig[]`	Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
`tiktokConfigs`	`TikTokConfig[]`	Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
`instagramConfigs`	`InstagramConfig[]`	Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
`facebookConfigs`	`FacebookConfig[]`	Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
`youtubeConfigs`	`YouTubeConfig[]`	Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
`googleBusinessConfigs`	`GoogleBusinessConfig[]`	Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
`tumblrConfigs`	`TumblrConfig[]`	Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag

Plattform-Konfigurationsüberschreibungen pro Beitrag

Plattform-Konfigurationen können auf zwei Ebenen festgelegt werden: Batch-Ebene (als Standard auf alle Beiträge angewendet) und pro Beitrag (überschreibt die Batch-Ebene für diesen spezifischen Beitrag). Wenn ein Beitrag seine eigene Plattform-Konfiguration enthält, ersetzt diese vollständig die Konfiguration auf Batch-Ebene für diese Plattform.

Ratenlimit

Maximal 100 Beiträge pro Anfrage. Jeder Beitrag wird unabhängig verarbeitet. Wenn einer die Validierung nicht besteht, werden die anderen trotzdem geplant.

Ein Konto pro Plattform

Pro Plattform ist nur ein Konto erlaubt. Alle Beiträge im Batch teilen dieselben Verbindungen, daher können Sie nicht mehrere Verbindungs-IDs für dieselbe Plattform angeben. Diese Einschränkung gilt zur Einhaltung der Nutzungsbedingungen der Plattformen.

Den Batch zuerst prüfen

Senden Sie denselben Body an Massenplanung prüfen (POST /api/v1/social-posts/bulk/validate), um für jeden Beitrag einen Bericht zu erhalten, bevor etwas geplant wird.

Beiträge in Masse planen

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/social-posts/bulk \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "platforms": ["YOUTUBE", "PINTEREST"],
    "timezone": "America/New_York",
    "youtubeConnectionIds": ["conn_yt123"],
    "pinterestConnectionIds": ["conn_pin456"],
    "youtubeConfigs": [{
      "connectionId": "conn_yt123",
      "postType": "SHORTS",
      "privacyStatus": "public"
    }],
    "pinterestConfigs": [{
      "connectionId": "conn_pin456",
      "boardId": "board_abc",
      "title": "Default pin title"
    }],
    "posts": [
      {
        "contentType": "VIDEO",
        "text": "First video!",
        "mediaUrls": ["https://cdn.adaptlypost.com/uploads/video1.mp4"],
        "scheduledAt": "2026-03-15T10:00:00Z"
      },
      {
        "contentType": "VIDEO",
        "text": "Second video with custom config",
        "mediaUrls": ["https://cdn.adaptlypost.com/uploads/video2.mp4"],
        "scheduledAt": "2026-03-15T14:00:00Z",
        "youtubeConfigs": [{
          "connectionId": "conn_yt123",
          "postType": "VIDEO",
          "videoTitle": "Full tutorial",
          "privacyStatus": "unlisted"
        }]
      }
    ]
  }'

201

{
  "totalScheduled": 2,
  "totalFailed": 0,
  "results": [
    {
      "postId": "post_abc001",
      "success": true,
      "isScheduled": true,
      "scheduledAt": "2026-03-15T10:00:00Z",
      "errorMessage": null
    },
    {
      "postId": "post_abc002",
      "success": true,
      "isScheduled": true,
      "scheduledAt": "2026-03-15T14:00:00Z",
      "errorMessage": null
    }
  ]
}