REST APIPOST

Massenplanung

Planen Sie mehrere Beitrage gleichzeitig mit plattformspezifischen Einstellungen

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)

Body-Parameter

ParameterTypBeschreibung
platformsERFORDERLICHPlatformType[]Zielplattformen für alle Beiträge
timezoneERFORDERLICHstringIANA-Zeitzone für die Planung
postsERFORDERLICHPostItem[]Array von zu planenden Beiträgen (1-100)
twitterConnectionIdsstring[]Twitter-Konto-Verbindungs-IDs
linkedinConnectionIdsstring[]LinkedIn-Konto-Verbindungs-IDs
instagramConnectionIdsstring[]Instagram-Konto-Verbindungs-IDs
tiktokConnectionIdsstring[]TikTok-Konto-Verbindungs-IDs
youtubeConnectionIdsstring[]YouTube-Kanal-Verbindungs-IDs
pinterestConnectionIdsstring[]Pinterest-Konto-Verbindungs-IDs
blueskyConnectionIdsstring[]Bluesky-Konto-Verbindungs-IDs
threadsConnectionIdsstring[]Threads-Konto-Verbindungs-IDs
pageIdsstring[]Facebook-/LinkedIn-Seiten-IDs
pinterestConfigsPinterestConfig[]Pinterest-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
tiktokConfigsTikTokConfig[]TikTok-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
instagramConfigsInstagramConfig[]Instagram-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
facebookConfigsFacebookConfig[]Facebook-Einstellungen auf Batch-Ebene, die auf alle Beiträge angewendet werden. Siehe Plattform-Konfigurationen für das Schema
youtubeConfigsYouTubeConfig[]YouTube-Einstellungen 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

ParameterTypBeschreibung
contentTypeERFORDERLICHContentTypeInhaltstyp (erforderlich)
textstringTextinhalt des Beitrags
platformTextsPlatformText[]Textspezifische Überschreibungen pro Plattform
mediaUrlsstring[]URLs der Mediendateien
thumbnailUrlstringThumbnail-URL für Videobeiträge
scheduledAtERFORDERLICHstringPlanungsdatum (erforderlich, ISO 8601)
pinterestConfigsPinterestConfig[]Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
tiktokConfigsTikTokConfig[]Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
instagramConfigsInstagramConfig[]Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
facebookConfigsFacebookConfig[]Überschreibung pro Beitrag. Wenn gesetzt, hat sie Vorrang vor der Konfiguration auf Batch-Ebene für diesen Beitrag
youtubeConfigsYouTubeConfig[]Ü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"
        }]
      }
    ]
  }'
200
{
  "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
    }
  ]
}