REST APIPOST

Planowanie zbiorcze

Zaplanuj do 100 postów w mediach społecznościowych naraz, z ustawieniami dla poszczególnych platform, za pomocą zbiorczego endpointu API AdaptlyPost.

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

Planuje do 100 postów naraz. Każdy post może mieć własną treść, multimedia i termin, przy wspólnych połączeniach platform.

Klucz API (token Bearer)
Uprawnienie:posts.scheduleRole i uprawnienia

posts.schedule, gdy każdy element ma przyszłą wartość scheduledAt. Element z datą bieżącą lub przeszłą jest publikowany od razu i klucz potrzebuje też posts.publish. Klucze Współtwórcy i Obserwatora nie mogą planować zbiorczo.

Parametry treści żądania

ParametrTypOpis
platformsWYMAGANEPlatformType[]Docelowe platformy wszystkich postów
timezoneWYMAGANEstringStrefa czasowa IANA do planowania
postsWYMAGANEPostItem[]Tablica postów do zaplanowania (1-100)
twitterConnectionIdsstring[]Identyfikatory połączeń kont Twitter
linkedinConnectionIdsstring[]Identyfikatory połączeń kont LinkedIn
instagramConnectionIdsstring[]Identyfikatory połączeń kont Instagram
tiktokConnectionIdsstring[]Identyfikatory połączeń kont TikTok
youtubeConnectionIdsstring[]Identyfikatory połączeń kanałów YouTube
pinterestConnectionIdsstring[]Identyfikatory połączeń kont Pinterest
blueskyConnectionIdsstring[]Identyfikatory połączeń kont Bluesky
mastodonConnectionIdsstring[]Identyfikatory połączeń kont Mastodon
googleBusinessConnectionIdsstring[]Identyfikatory połączeń lokalizacji Google Business Profile
tumblrConnectionIdsstring[]Identyfikatory połączeń blogów Tumblr
wordpressConnectionIdsstring[]Identyfikatory połączeń witryn WordPress
telegramConnectionIdsstring[]Identyfikatory połączeń kanałów i grup Telegram
threadsConnectionIdsstring[]Identyfikatory połączeń kont Threads
pageIdsstring[]Strony na Facebooku, na których ma się pojawić post. Przyjmuje id konta lub pageId z /social-accounts
pinterestConfigsPinterestConfig[]Ustawienia Pinterest na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform
tiktokConfigsTikTokConfig[]Ustawienia TikTok na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform
instagramConfigsInstagramConfig[]Ustawienia Instagram na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform
facebookConfigsFacebookConfig[]Ustawienia Facebook na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform
youtubeConfigsYouTubeConfig[]Ustawienia YouTube na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform
googleBusinessConfigsGoogleBusinessConfig[]Ustawienia Google Business Profile na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform
tumblrConfigsTumblrConfig[]Ustawienia Tumblr na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform
wordpressConfigsWordPressConfig[]Ustawienia WordPress na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform

Pola elementu posta

Każdy post w tablicy może mieć własną treść, multimedia i termin publikacji.

Parametry elementu posta

ParametrTypOpis
contentTypeWYMAGANEContentTypeTyp treści: TEXT, IMAGE, VIDEO lub CAROUSEL (wymagany)
textstringTreść posta. Na LinkedIn stronę firmową można oznaczyć za pomocą @[Page Name](urn:li:organization:<id>), podając nazwę strony dokładnie tak, jak wyświetla ją LinkedIn. LinkedIn pozwala oznaczać tylko strony firmowe, nie osoby. GET /api/v1/linkedin-organizations/lookup (zob. Konta społecznościowe) zwraca taką wzmiankę dla adresu URL strony lub jej nazwy własnej
platformTextsPlatformText[]Osobne teksty dla poszczególnych platform
mediaUrlsstring[]Adresy URL plików multimedialnych
mediaAltTextsstring[]Tekst alternatywny każdego obrazu, w tej samej kolejności co mediaUrls. Maks. 1000 znaków każdy; pusty ciąg pomija obraz. Wysyłany do X, Bluesky, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram i Threads. Pinterest używa pierwszego, skróconego do 500 znaków. TikTok, YouTube, Google Business Profile i filmy go ignorują.
thumbnailUrlstringMiniatura posta wideo jako adres URL https lub data URI obrazu. Używa jej każda platforma obsługująca miniatury, chyba że platformThumbnails ją nadpisuje
thumbnailTimestampMsnumberKlatka filmu użyta jako miniatura, w milisekundach od początku. Działa na YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST, TELEGRAM i TIKTOK. Wysłany razem z nią thumbnailUrl ma pierwszeństwo wszędzie poza TIKTOK, który przyjmuje tylko klatkę. platformThumbnails nadpisuje oba
platformThumbnailsPlatformThumbnail[]Inna miniatura dla jednej platformy w poście wideo, jako { platform, thumbnailUrl?, thumbnailTimestampMs? }. YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST i TELEGRAM przyjmują obraz lub klatkę, a gdy wysłano oba, używają obrazu. TIKTOK przyjmuje tylko klatkę. Platformy bez wpisu używają thumbnailUrl i thumbnailTimestampMs
platformMediaPlatformMedia[]Osobne multimedia dla jednej platformy, gdy multimedia posta do niej nie pasują, np. film za długi na TikToka lub karuzela z większą liczbą obrazów, niż przyjmuje X. Należy wysłać { platform, mediaUrls, mediaAltTexts? }, po jednym wpisie na platformę posta. mediaUrls to przesłane adresy URL https, a nie data URI, i muszą odpowiadać contentType: jeden film dla VIDEO, jeden obraz dla IMAGE, jeden dokument dla DOCUMENT, co najmniej dwa elementy dla CAROUSEL. Posty TEXT ich nie przyjmują. mediaAltTexts ma kolejność mediaUrls wpisu, maks. 1000 znaków każdy. Wpis jest sprawdzany pod kątem limitów tej platformy zamiast mediaUrls, a platforma pobiera miniaturę wyłącznie z platformThumbnails. Platformy bez wpisu używają mediaUrls
platformAspectRatiosPlatformAspectRatio[]Dopasowuje wszystkie obrazy posta IMAGE lub CAROUSEL do jednego kształtu na platformie, jako { platform, aspectRatio, fit? }. aspectRatio to SQUARE, PORTRAIT, VERTICAL lub LANDSCAPE: INSTAGRAM przyjmuje SQUARE, PORTRAIT lub LANDSCAPE, TIKTOK wszystkie cztery. fit to CROP (domyślnie) lub PAD. Zob. Utwórz post
firstCommentsPlatformFirstComment[]Komentarz publikowany pod postem z tego samego konta, jako { platform, text, delayMinutes }. Jeden wpis na platformę. LINKEDIN przyjmuje do 1250 znaków, TWITTER 280, THREADS 500, BLUESKY 300, MASTODON 500, YOUTUBE 10000 (nie dla filmów prywatnych i przeznaczonych dla dzieci), FACEBOOK 8000, a INSTAGRAM 2200 (nie dla relacji). Inne platformy zwracają 400. Strona na Facebooku lub konto Instagram połączone przed wprowadzeniem pierwszych komentarzy wymaga jednorazowego ponownego połączenia; do tego czasu komentarz kończy się błędem firstCommentError. delayMinutes (od 0 do 10080, czyli 7 dni) opóźnia komentarz o podaną liczbę minut od publikacji na platformie. Pominięcie lub 0 publikuje go od razu. Usunięcie posta przed tym terminem anuluje komentarz
threadRepliesPlatformThreadReplies[]Zamienia post w wątek, jako { platform, texts, mediaUrls }: post go otwiera, a każdy tekst jest publikowany jako odpowiedź na poprzedni, z tego samego konta. Jeden wpis na platformę, do 25 tekstów. TWITTER przyjmuje 280 znaków na odpowiedź (więcej w X Premium), THREADS 500, BLUESKY 300, a MASTODON 500 (lub limit instancji). mediaUrls jest opcjonalne i odpowiada kolejnością polu texts: do 4 obrazów JPEG, PNG, GIF lub WEBP na odpowiedź, z POST /upload-urls, oraz [] dla odpowiedzi bez obrazów. Odpowiedź z obrazami może mieć pusty tekst. Inne platformy, odpowiedź bez tekstu i obrazów, zbyt długa odpowiedź, więcej niż 4 obrazy lub film w odpowiedzi oraz platforma mająca też pierwszy komentarz zwracają 400
scheduledAtWYMAGANEstringData publikacji (wymagana, ISO 8601)
pinterestConfigsPinterestConfig[]Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta
tiktokConfigsTikTokConfig[]Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta
instagramConfigsInstagramConfig[]Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta
facebookConfigsFacebookConfig[]Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta
youtubeConfigsYouTubeConfig[]Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta
googleBusinessConfigsGoogleBusinessConfig[]Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta
tumblrConfigsTumblrConfig[]Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta
wordpressConfigsWordPressConfig[]Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta

Nadpisywanie konfiguracji platform dla posta

Konfiguracje platform można ustawić na dwóch poziomach: partii (domyślnie dla wszystkich postów) i posta (nadpisuje poziom partii dla danego posta). Jeśli post ma własną konfigurację platformy, całkowicie zastępuje ona konfigurację partii dla tej platformy.

Limit żądań

Maksymalnie 100 postów na żądanie. Każdy post jest przetwarzany niezależnie: jeśli jeden nie przejdzie walidacji, pozostałe i tak zostaną zaplanowane.

Jedno konto na platformę

Dozwolone jest tylko jedno konto na platformę. Wszystkie posty w partii mają wspólne połączenia, więc nie można podać kilku identyfikatorów połączeń dla tej samej platformy. Ograniczenie wynika z regulaminów platform.

Najpierw sprawdzenie partii

Wysłanie tej samej treści do Sprawdź planowanie zbiorcze (POST /api/v1/social-posts/bulk/validate) zwraca raport dla każdego posta, zanim cokolwiek zostanie zaplanowane.
Zbiorcze planowanie postów
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
    }
  ]
}