REST API

Massenplanung

Mehrere Beiträge gleichzeitig planen

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

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 account connection IDs
`linkedinConnectionIds`	`string[]`	LinkedIn account connection IDs
`instagramConnectionIds`	`string[]`	Instagram account connection IDs
`tiktokConnectionIds`	`string[]`	TikTok account connection IDs
`youtubeConnectionIds`	`string[]`	YouTube channel connection IDs
`pinterestConnectionIds`	`string[]`	Pinterest account connection IDs
`blueskyConnectionIds`	`string[]`	Bluesky account connection IDs
`threadsConnectionIds`	`string[]`	Threads account connection IDs
`pageIds`	`string[]`	Facebook/LinkedIn page IDs
`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

Beitragselement-Felder

Each post in the array can have its own content, media, and schedule time.

Post Item Parameters

Parameter	Typ	Beschreibung
`contentType`ERFORDERLICH	`ContentType`	Inhaltstyp (erforderlich)
`text`	`string`	Textinhalt des Beitrags
`platformTexts`	`PlatformText[]`	Per-platform text overrides
`mediaUrls`	`string[]`	URLs der Mediendateien
`thumbnailUrl`	`string`	Thumbnail URL for video posts
`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

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.

Rate limit

Maximum 100 posts per request. Each post is processed independently — if one fails validation, others will still be scheduled.

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

Massenplanung

Body-Parameter

Beitragselement-Felder

Post Item Parameters

AdaptlyPost

Kontakt