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

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
`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 und LINKEDIN nehmen ein Bild, INSTAGRAM und PINTEREST ein Bild oder ein Videobild, TIKTOK nur ein Videobild. Plattformen ohne Eintrag nutzen thumbnailUrl und thumbnailTimestampMs
`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 und YOUTUBE 10000 (nicht bei privaten oder für Kinder gemachten Videos). Andere Plattformen 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

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.

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