REST APIPOST

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.

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

Tworzy nowy post. Posty można publikować od razu, planować na później lub zapisywać jako wersje robocze.

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

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

ParametrTypOpis
platformsPlatformType[]Docelowe platformy (np. TWITTER, LINKEDIN, INSTAGRAM). Każda wymaga też swoich identyfikatorów połączeń. Wymagane, chyba że wysłano accountIds
accountIdsstring[]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
contentTypeWYMAGANEContentTypeTEXT, 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
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 przesłanych 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? }. 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
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
scheduledAtstringData planowania w formacie ISO 8601. Pominięcie oznacza natychmiastową publikację. Z saveAsDraft: true jest to planowana data wersji roboczej, a post pozostaje wersją roboczą.
timezoneWYMAGANEstringStrefa czasowa IANA (np. America/New_York)
saveAsDraftbooleanZapisuje jako wersję roboczą zamiast publikować. Dodanie scheduledAt zachowuje planowaną datę publikacji; nic nie zostanie opublikowane przed wywołaniem Opublikuj wersję roboczą.
recurrenceRecurrencePowtarza post według harmonogramu. Wymaga przyszłej wartości scheduledAt. Zob. Posty cykliczne poniżej
twitterConnectionIdsstring[]Identyfikatory połączeń kont Twitter
twitterKeepLinksbooleanZachowuje 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
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
googleBusinessConfigsGoogleBusinessConfig[]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
tumblrConnectionIdsstring[]Identyfikatory połączeń blogów Tumblr
wordpressConnectionIdsstring[]Identyfikatory połączeń witryn WordPress
telegramConnectionIdsstring[]Identyfikatory połączeń kanałów i grup Telegram
tumblrConfigsTumblrConfig[]Ustawienia posta Tumblr dla każdego bloga: tagi, tytuł i link do źródła. Schemat opisano w sekcji Konfiguracje platform
wordpressConfigsWordPressConfig[]Ustawienia posta WordPress dla każdej witryny: tytuł, zajawka, kategorie, tagi i status. Schemat opisano w sekcji Konfiguracje platform
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 tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
tiktokConfigsTikTokConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
instagramConfigsInstagramConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
facebookConfigsFacebookConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
youtubeConfigsYouTubeConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
linkedinConfigsLinkedInConfig[]Ustawienia tej platformy, po jednym obiekcie na konto, każdy ze wskazaniem connectionId, którego dotyczy (pageId dla Facebooka). Zob. Konfiguracje platform
twitterConfigsTwitterConfig[]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.

Gdy platforma nie ma wpisu w platformTexts, używane jest domyślne pole text.

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

ParametrTypOpis
frequencyWYMAGANERecurrenceFrequencyDAILY, WEEKLY, MONTHLY lub YEARLY. YEARLY publikuje co roku tego samego dnia; seria rozpoczęta 29 lutego w pozostałych latach publikuje 28 lutego
intervalnumberPowtarzanie co N dni, tygodni, miesięcy lub lat (1-30, domyślnie: 1)
weekdaysWeekday[]Tylko WEEKLY. Dni publikacji, od MONDAY do SUNDAY. Dzień tygodnia z scheduledAt jest zawsze uwzględniany
endsOnstringOstatni 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
maxOccurrencesnumberŁą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
Odpowiedź zawiera dodatkowo recurringPostId, a postId to pierwszy post serii. recurringPostId należy przekazać do endpointów Posty cykliczne, aby wstrzymać, wznowić lub usunąć serię.

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"
    }
  ]
}
Aby zobaczyć te problemy bez tworzenia czegokolwiek, należy najpierw wysłać tę samą treść do Sprawdź post (POST /api/v1/social-posts/validate).
Utworzenie posta
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"]
  }'
Utworzenie posta cyklicznego
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
    }
  }'
201
{
  "postId": "post_xyz789",
  "queuedPlatforms": ["TWITTER", "LINKEDIN"],
  "skippedPlatforms": [],
  "isScheduled": false,
  "scheduledAt": null
}