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.
https://post.adaptlypost.com/post/api/v1/social-posts/bulkPlanuje do 100 postów naraz. Każdy post może mieć własną treść, multimedia i termin, przy wspólnych połączeniach platform.
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
| Parametr | Typ | Opis |
|---|---|---|
platformsWYMAGANE | PlatformType[] | Docelowe platformy wszystkich postów |
timezoneWYMAGANE | string | Strefa czasowa IANA do planowania |
postsWYMAGANE | PostItem[] | Tablica postów do zaplanowania (1-100) |
twitterConnectionIds | string[] | Identyfikatory połączeń kont Twitter |
linkedinConnectionIds | string[] | Identyfikatory połączeń kont LinkedIn |
instagramConnectionIds | string[] | Identyfikatory połączeń kont Instagram |
tiktokConnectionIds | string[] | Identyfikatory połączeń kont TikTok |
youtubeConnectionIds | string[] | Identyfikatory połączeń kanałów YouTube |
pinterestConnectionIds | string[] | Identyfikatory połączeń kont Pinterest |
blueskyConnectionIds | string[] | Identyfikatory połączeń kont Bluesky |
mastodonConnectionIds | string[] | Identyfikatory połączeń kont Mastodon |
googleBusinessConnectionIds | string[] | Identyfikatory połączeń lokalizacji Google Business Profile |
tumblrConnectionIds | string[] | Identyfikatory połączeń blogów Tumblr |
wordpressConnectionIds | string[] | Identyfikatory połączeń witryn WordPress |
telegramConnectionIds | string[] | Identyfikatory połączeń kanałów i grup Telegram |
threadsConnectionIds | string[] | Identyfikatory połączeń kont Threads |
pageIds | string[] | Strony na Facebooku, na których ma się pojawić post. Przyjmuje id konta lub pageId z /social-accounts |
pinterestConfigs | PinterestConfig[] | Ustawienia Pinterest na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform |
tiktokConfigs | TikTokConfig[] | Ustawienia TikTok na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform |
instagramConfigs | InstagramConfig[] | Ustawienia Instagram na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform |
facebookConfigs | FacebookConfig[] | Ustawienia Facebook na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform |
youtubeConfigs | YouTubeConfig[] | Ustawienia YouTube na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform |
googleBusinessConfigs | GoogleBusinessConfig[] | Ustawienia Google Business Profile na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform |
tumblrConfigs | TumblrConfig[] | Ustawienia Tumblr na poziomie partii, stosowane do wszystkich postów. Schemat opisano w sekcji Konfiguracje platform |
wordpressConfigs | WordPressConfig[] | 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
| Parametr | Typ | Opis |
|---|---|---|
contentTypeWYMAGANE | ContentType | Typ treści: TEXT, IMAGE, VIDEO lub CAROUSEL (wymagany) |
text | string | Treść 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 |
platformTexts | PlatformText[] | Osobne teksty dla poszczególnych platform |
mediaUrls | string[] | Adresy URL plików multimedialnych |
mediaAltTexts | string[] | 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ą. |
thumbnailUrl | string | Miniatura 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 |
thumbnailTimestampMs | number | Klatka 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 |
platformThumbnails | PlatformThumbnail[] | 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 |
platformMedia | PlatformMedia[] | 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 |
platformAspectRatios | PlatformAspectRatio[] | 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 |
firstComments | PlatformFirstComment[] | 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 |
threadReplies | PlatformThreadReplies[] | 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 |
scheduledAtWYMAGANE | string | Data publikacji (wymagana, ISO 8601) |
pinterestConfigs | PinterestConfig[] | Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta |
tiktokConfigs | TikTokConfig[] | Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta |
instagramConfigs | InstagramConfig[] | Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta |
facebookConfigs | FacebookConfig[] | Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta |
youtubeConfigs | YouTubeConfig[] | Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta |
googleBusinessConfigs | GoogleBusinessConfig[] | Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta |
tumblrConfigs | TumblrConfig[] | Nadpisanie dla posta. Jeśli je ustawiono, ma pierwszeństwo przed konfiguracją partii dla tego posta |
wordpressConfigs | WordPressConfig[] | 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.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"
}]
}
]
}'{
"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
}
]
}