Utwórz post przez API
Opublikuj lub zaplanuj post na wielu platformach społecznościowych jednym wywołaniem API, z treścią i multimediami dopasowanymi do każdej platformy.
https://post.adaptlypost.com/post/api/v1/social-postsTworzy nowy post. Posty można publikować od razu, planować na później lub zapisywać jako wersje robocze.
Gdy saveAsDraft ma wartość true, wystarczy posts.draft. Przyszła wartość scheduledAt wymaga posts.schedule. Brak scheduledAt lub miniony termin oznacza natychmiastową publikację i wymaga posts.publish. Klucz Współtwórcy może więc tylko zapisywać wersje robocze.
Parametry treści żądania
| Parametr | Typ | Opis |
|---|---|---|
platforms | PlatformType[] | Docelowe platformy (np. TWITTER, LINKEDIN, INSTAGRAM). Każda wymaga też swoich identyfikatorów połączeń. Wymagane, chyba że wysłano accountIds |
accountIds | string[] | Id kont (lub pageId Facebooka) z /social-accounts, na które ma trafić post. AdaptlyPost dodaje platformę każdego konta do platforms, a jego id do odpowiedniej listy identyfikatorów połączeń, więc można je wysłać zamiast platforms i list dla poszczególnych platform lub razem z nimi. Id niepołączone z obszarem roboczym zwraca 400 |
contentTypeWYMAGANE | ContentType | TEXT, IMAGE, VIDEO, CAROUSEL lub DOCUMENT. DOCUMENT działa tylko na LinkedIn: dokładnie jeden plik PDF, PPT, PPTX, DOC lub DOCX w mediaUrls, wyświetlany jako dokument do przewijania |
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 przesłanych 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? }. Jeden wpis na platformę. aspectRatio to SQUARE (1:1), PORTRAIT (4:5), VERTICAL (9:16) lub LANDSCAPE (1.91:1): INSTAGRAM przyjmuje SQUARE, PORTRAIT lub LANDSCAPE, TIKTOK wszystkie cztery. fit to CROP (domyślnie, kadrowanie od środka) lub PAD (zachowanie całego obrazu i wypełnienie reszty rozmytą kopią). Inne platformy, posty wideo, relacje na Instagramie i drugi wpis dla tej samej platformy zwracają 400. Platformy bez wpisu zachowują obrazy w przesłanej postaci |
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 |
scheduledAt | string | Data planowania w formacie ISO 8601. Pominięcie oznacza natychmiastową publikację. Z saveAsDraft: true jest to planowana data wersji roboczej, a post pozostaje wersją roboczą. |
timezoneWYMAGANE | string | Strefa czasowa IANA (np. America/New_York) |
saveAsDraft | boolean | Zapisuje jako wersję roboczą zamiast publikować. Dodanie scheduledAt zachowuje planowaną datę publikacji; nic nie zostanie opublikowane przed wywołaniem Opublikuj wersję roboczą. |
recurrence | Recurrence | Powtarza post według harmonogramu. Wymaga przyszłej wartości scheduledAt. Zob. Posty cykliczne poniżej |
twitterConnectionIds | string[] | Identyfikatory połączeń kont Twitter |
twitterKeepLinks | boolean | Zachowuje klikalne linki w tekście na X. Domyślnie każdy link w tekście na X jest rozbijany (example.com staje się example. com), ponieważ X pobiera ponad 10 razy więcej za post z linkiem. Tę opcję mogą włączyć tylko konta z dożywotnią ofertą AppSumo: zachowany link kosztuje 20 kredytów zamiast 2, także w pierwszym komentarzu na X, a bez wystarczającej liczby kredytów post na X się nie powiedzie. true w każdym innym planie zwraca 400. Ignorowane, gdy tekst na X nie zawiera linku |
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 |
googleBusinessConfigs | GoogleBusinessConfig[] | Ustawienia posta Google Business Profile dla każdej lokalizacji: typ posta (aktualność, wydarzenie lub oferta), przycisk, daty wydarzenia i szczegóły oferty. Schemat opisano w sekcji Konfiguracje platform |
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 |
tumblrConfigs | TumblrConfig[] | Ustawienia posta Tumblr dla każdego bloga: tagi, tytuł i link do źródła. Schemat opisano w sekcji Konfiguracje platform |
wordpressConfigs | WordPressConfig[] | Ustawienia posta WordPress dla każdej witryny: tytuł, zajawka, kategorie, tagi i status. Schemat opisano w sekcji Konfiguracje platform |
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 tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
tiktokConfigs | TikTokConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
instagramConfigs | InstagramConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
facebookConfigs | FacebookConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
youtubeConfigs | YouTubeConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
linkedinConfigs | LinkedInConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
twitterConfigs | TwitterConfig[] | Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform |
Tekst dla poszczególnych platform
platformTexts pozwala dostosować treść do każdej platformy w ramach tego samego posta.
Jedno konto na platformę
W jednym poście dozwolone jest tylko jedno konto na platformę. Nie można na przykład podać dwóch identyfikatorów połączeń Twittera w tym samym żądaniu. Ograniczenie wynika z regulaminów platform. Jego naruszenie zwraca błąd 400.Posty cykliczne
Dodanie obiektu recurrence powoduje powtarzanie posta. Post z terminem scheduledAt jest pierwszym w serii i wyznacza godzinę publikacji w podanej strefie czasowej. W danym momencie istnieje tylko kolejny post z serii. AdaptlyPost tworzy go około 24 godzin przed publikacją.
Obiekt recurrence
| Parametr | Typ | Opis |
|---|---|---|
frequencyWYMAGANE | RecurrenceFrequency | DAILY, WEEKLY, MONTHLY lub YEARLY. YEARLY publikuje co roku tego samego dnia; seria rozpoczęta 29 lutego w pozostałych latach publikuje 28 lutego |
interval | number | Powtarzanie co N dni, tygodni, miesięcy lub lat (1-30, domyślnie: 1) |
weekdays | Weekday[] | Tylko WEEKLY. Dni publikacji, od MONDAY do SUNDAY. Dzień tygodnia z scheduledAt jest zawsze uwzględniany |
endsOn | string | Ostatni dzień, w którym może się ukazać post, w formacie YYYY-MM-DD. Nie może być wcześniejszy niż dzień pierwszego posta. Nie można łączyć z maxOccurrences |
maxOccurrences | number | Łączna liczba postów w serii (2-365). Nie można łączyć z endsOn. Bez obu parametrów seria powtarza się do czasu wstrzymania lub usunięcia |
Zasady postów cyklicznych
Post cykliczny nie może używać saveAsDraft: true ani zawierać konta TikTok. Każdy z tych przypadków zwraca 400. Terminy pominięte podczas wstrzymania serii przepadają i nigdy nie są publikowane z opóźnieniem. X i LinkedIn odrzucają tekst zgodny z wcześniejszym postem, dlatego warto dodać spintax, np. {Hi|Hello}, aby każdy post był inny.Gdy post zostanie odrzucony
Post odrzucony z powodu treści zwraca 400 z kodem post_validation_failed oraz issues, czyli listą wszystkich wykrytych problemów, w tym samym kształcie co issues w Sprawdź post. message to treść problemu, a jeśli jest ich kilka, lista treści.
{
"statusCode": 400,
"error": "Bad Request",
"code": "post_validation_failed",
"message": [
"Text exceeds maximum length for Twitter/X. Maximum is 280 characters",
"Video duration (185s) exceeds your TikTok account limit of 180 seconds"
],
"issues": [
{
"code": "TEXT_TOO_LONG",
"severity": "ERROR",
"message": "Text exceeds maximum length for Twitter/X. Maximum is 280 characters",
"platform": "TWITTER",
"connectionId": "conn_abc123"
},
{
"code": "TIKTOK_VIDEO_TOO_LONG",
"severity": "ERROR",
"message": "Video duration (185s) exceeds your TikTok account limit of 180 seconds",
"platform": "TIKTOK",
"connectionId": "conn_tt789"
}
]
}curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/social-posts \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"platforms": ["TWITTER", "LINKEDIN"],
"contentType": "TEXT",
"text": "Exciting product update!",
"timezone": "America/New_York",
"twitterConnectionIds": ["conn_abc123"],
"linkedinConnectionIds": ["conn_def456"]
}'curl --request POST \
--url https://post.adaptlypost.com/post/api/v1/social-posts \
--header 'Authorization: Bearer <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"platforms": ["LINKEDIN"],
"contentType": "TEXT",
"text": "{Hi|Hello} everyone, the weekly product tip is live!",
"scheduledAt": "2026-10-05T13:00:00Z",
"timezone": "America/New_York",
"linkedinConnectionIds": ["conn_def456"],
"recurrence": {
"frequency": "WEEKLY",
"weekdays": ["MONDAY", "THURSDAY"],
"maxOccurrences": 12
}
}'{
"postId": "post_xyz789",
"queuedPlatforms": ["TWITTER", "LINKEDIN"],
"skippedPlatforms": [],
"isScheduled": false,
"scheduledAt": null
}