Platforms

Konfiguracje platform

Opcje konfiguracji dla poszczególnych platform, które pozwalają dopracować publikowanie na YouTube, TikToku, Pintereście, Instagramie, Facebooku, LinkedInie, X, w Google Business Profile, Tumblrze i WordPressie.

Każda platforma ma własne funkcje i ustawienia. Poniższe obiekty konfiguracji pozwalają dostosować działanie do platformy przy tworzeniu postów.

TikTok

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
titlestringPosty ze zdjęciami: tytuł wyświetlany nad opisem. Posty wideo: wysyłany jako podpis tylko wtedy, gdy caption jest puste. Maks. 90 znaków
captionstringPosty ze zdjęciami: opis, do 4000 znaków. Posty wideo: podpis, do 2200 znaków. W razie braku używany jest title, a potem tekst posta. Film wysłany z sendAsDraft może trafić do skrzynki TikToka bez podpisu, ponieważ przesyłanie do skrzynki TikToka go nie obsługuje
privacyLevelWYMAGANEstringPUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY
allowCommentsbooleanZezwala na komentarze pod filmem
allowDuetbooleanZezwala na duety
allowStitchbooleanZezwala na stitche
sendAsDraftbooleanWysyła jako wersję roboczą do aplikacji TikTok
aiGeneratedbooleanOznacza jako treść wygenerowaną przez AI
autoAddMusicbooleanAutomatycznie dodaje muzykę do filmu
brandedContentbooleanOznacza jako treść sponsorowaną
brandedContentOwnBrandbooleanOznacza jako promocję własnej marki
Przykład
{
  "tiktokConfigs": [{
    "connectionId": "conn_tiktok_001",
    "title": "Product Demo",
    "privacyLevel": "PUBLIC_TO_EVERYONE",
    "allowComments": true,
    "allowDuet": false,
    "aiGenerated": false
  }]
}

YouTube

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
postTypestringVIDEO lub SHORTS
videoTitlestringTytuł filmu (maks. 100 znaków)
tagsstring[]Tagi filmu ułatwiające wyszukiwanie (maks. 20)
privacyStatusstringpublic, unlisted lub private
categoryIdstringID kategorii YouTube
playlistIdstringDodaje do playlisty po przesłaniu
notifySubscribersbooleanPowiadamia subskrybentów (domyślnie true)
allowEmbeddingbooleanZezwala na osadzanie w innych witrynach
madeForKidsbooleanOznacza jako przeznaczone dla dzieci
aiGeneratedbooleanUjawnia treści zmienione lub syntetyczne, takie jak głos AI, awatar AI albo realistyczne wygenerowane lub edytowane nagrania. YouTube pokazuje na filmie etykietę „Altered or synthetic content”. Ustawia status.containsSyntheticMedia. Działa dla filmów i Shortów. Pominięcie lub false oznacza brak etykiety.
licensestringyoutube lub creativeCommon
defaultAudioLanguagestring | nullJęzyk oryginalnej ścieżki dźwiękowej filmu jako tag BCP-47, np. en, pt-BR lub es-419 (maks. 35 znaków). Dzięki niemu YouTube nie uzna np. dźwięku po portugalsku za angielski. null usuwa zapisaną wartość. Nie wyłącza automatycznego dubbingu YouTube
scheduleOnYouTubebooleanPrzesyła film od razu po zaplanowaniu posta jako prywatny, a YouTube upublicznia go w terminie scheduledAt, dzięki czemu można wcześniej przygotować test miniatury lub tytułu w YouTube Studio. Wymaga privacyStatus public: inna wartość zwraca 400 z YOUTUBE_SCHEDULE_REQUIRES_PUBLIC, a post cykliczny 400 z YOUTUBE_SCHEDULE_NOT_RECURRING. Gdy do scheduledAt zostało mniej niż 15 minut, film jest przesyłany w terminie scheduledAt jak zwykle. Gdy film czeka na YouTube, aktualizacja posta lub cofnięcie zaplanowania zwraca 409 z SCHEDULED_ON_YOUTUBE. Usunięcie posta przed scheduledAt usuwa też film z YouTube; jeśli YouTube odmówi, post pozostaje, a usunięcie zwraca 502 z SCHEDULED_VIDEO_DELETE_FAILED
Przykład
{
  "youtubeConfigs": [{
    "connectionId": "conn_yt_001",
    "postType": "VIDEO",
    "videoTitle": "Weekly Product Update",
    "tags": ["product", "update", "tech"],
    "privacyStatus": "PUBLIC",
    "notifySubscribers": true,
    "allowEmbedding": true,
    "madeForKids": false,
    "defaultAudioLanguage": "pt-BR"
  }]
}

Pinterest

Tablicę wybiera się przez boardId lub boardName. GET /api/v1/social-accounts/:id/pinterest-boards (zob. Konta społecznościowe) zwraca id i nazwę każdej tablicy. Tablica należy do jednego konta Pinterest, dlatego listę trzeba pobrać dla każdego konta, na które trafia post. boardName jest wyszukiwana wśród tablic konta z tej konfiguracji podczas obsługi żądania, a post zapisuje id dopasowanej tablicy; sama nazwa nie jest zapisywana ani zwracana. Nazwa niepasująca do żadnej tablicy lub pasująca do kilku zwraca 400, a pin nigdy nie trafia na inną tablicę. W żądaniu zbiorczym niepowodzeniem kończy się tylko ten element. Bez boardId i boardName pin trafia na publiczną tablicę o nazwie AdaptlyPost, którą AdaptlyPost tworzy na koncie Pinterest przy pierwszej potrzebie.

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
boardIdstringID tablicy Pinterest, na którą trafi pin. Należy podać boardId lub boardName, nie oba. Bez nich pin trafia na publiczną tablicę o nazwie AdaptlyPost
boardNamestringNazwa tablicy, na którą trafi pin, zamiast boardId. Do 180 znaków. Pierwszeństwo ma dokładne dopasowanie; bez niego używane jest jedyne dopasowanie bez rozróżniania wielkości liter. Nazwa niepasująca do żadnej tablicy lub pasująca do kilku zwraca 400
titlestringTytuł pina (maks. 100 znaków)
linkstringDocelowy adres URL po kliknięciu pina
Przykład
{
  "pinterestConfigs": [{
    "connectionId": "conn_pin_001",
    "boardId": "board_123",
    "title": "Summer Collection 2026",
    "link": "https://example.com/summer-collection"
  }]
}

Instagram

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
postTypestringFEED, REEL lub STORY. FEED działa z każdym typem treści, REEL wymaga VIDEO, STORY wymaga IMAGE, VIDEO lub CAROUSEL; relacja CAROUSEL publikuje każdy element jako osobną relację, po kolei. Każda inna kombinacja zwraca 400. Filmy w FEED i Reelach mogą trwać do 15 minut
shareToStorybooleanPublikuje te same multimedia także jako relację obok posta FEED lub REEL. Relacja jest osobnym wpisem w platforms z postType STORY, więc powodzenie, błąd i ponowienie dotyczą jej niezależnie. Pomija podpis, pierwszy komentarz, okładkę, współautorów, tryb próbny i dźwięk, wymaga IMAGE, VIDEO lub CAROUSEL, a film może trwać maksymalnie 60 sekund. Ignorowane, gdy postType to STORY
trialGraduationstringPublikuje Reela jako próbnego, pokazywanego najpierw osobom nieobserwującym. MANUAL: udostępnienie obserwującym odbywa się ręcznie w aplikacji Instagram. SS_PERFORMANCE: Instagram udostępnia go, jeśli dobrze sobie radzi. Tylko Reele wideo; dla zwykłego Reela należy pominąć
collaboratorsstring[]Do 3 nazw użytkowników Instagrama zaproszonych do współpracy (Instagram Collab). Początkowy znak @ jest usuwany. Działa dla obrazów w feedzie, karuzel i Reeli, nie dla relacji ani Reeli próbnych. Każdy współautor musi przyjąć zaproszenie na Instagramie, zanim post pojawi się na jego profilu.
userTagsobject[]Do 20 publicznych kont Instagram oznaczonych w multimediach, każde jako { username, x, y }. Działa dla pojedynczego obrazu, filmu (Reela) lub relacji, nie dla karuzel. x i y przyjmują wartości od 0 do 1 na obrazie, licząc od lewego górnego rogu, a każde oznaczenie na obrazie w feedzie wymaga obu. Relacja może je pominąć, a film je ignoruje, ponieważ osoba jest oznaczana na całym filmie. Początkowy znak @ jest usuwany. Jeśli Instagram odrzuci oznaczenie, bo konto jest prywatne lub nie istnieje, post ukazuje się bez oznaczeń, a instagramUntaggedUsernames zawiera odrzucone nazwy.
aiGeneratedbooleanUjawnia, że post utworzono lub edytowano z pomocą AI. Instagram pokazuje na poście etykietę „AI info”. Działa dla obrazów, karuzel, Reeli i relacji, a relacja utworzona przez shareToStory też ma tę etykietę.
audioInstagramAudioMuzyka lub oryginalny dźwięk dodany do Reela. Wymaga contentType VIDEO, postType innego niż STORY i konta z supportsInstagramAudio: true. Zob. Dźwięk na Instagramie poniżej
Przykład
{
  "contentType": "VIDEO",
  "instagramConfigs": [{
    "connectionId": "conn_ig_001",
    "postType": "REEL",
    "shareToStory": true,
    "collaborators": ["@partnerbrand"],
    "audio": {
      "audioId": "1234567890123456",
      "title": "Summer Nights",
      "artist": "The Example Band",
      "audioVolume": 60,
      "videoVolume": 100
    }
  }]
}

Dźwięk na Instagramie

audioId można znaleźć przez GET /api/v1/social-accounts/:id/instagram-audio (zob. Konta społecznościowe), a następnie przekazać w instagramConfigs[].audio.

ParametrTypOpis
audioIdWYMAGANEstringaudioId z wyszukiwania dźwięków
titlestringTytuł utworu, zapisywany tylko do wyświetlania (maks. 255 znaków)
artiststringWykonawca lub twórca, zapisywany tylko do wyświetlania (maks. 255 znaków)
audioVolumenumberGłośność dodanego dźwięku, od 1 do 100 (domyślnie 100)
videoVolumenumberGłośność własnego dźwięku filmu, od 1 do 100 (domyślnie 100)

Facebook

ParametrTypOpis
pageIdWYMAGANEstringStrona na Facebooku, której dotyczy ta konfiguracja, tak jak wysłano w pageIds
postTypestringFEED, REEL lub STORY. FEED działa z każdym typem treści, REEL wymaga VIDEO, STORY wymaga IMAGE, VIDEO lub CAROUSEL; relacja CAROUSEL publikuje każdy element jako osobną relację, po kolei. Każda inna kombinacja zwraca 400. Film w Reelu może trwać do 240 minut
shareToStorybooleanPublikuje te same multimedia także jako relację obok posta FEED lub REEL. Relacja jest osobnym wpisem w platforms z postType STORY, więc powodzenie, błąd i ponowienie dotyczą jej niezależnie. Pomija podpis, tytuł filmu i tło tekstu, wymaga IMAGE, VIDEO lub CAROUSEL, a film może trwać maksymalnie 60 sekund. Ignorowane, gdy postType to STORY
aiGeneratedbooleanUjawnia, że post utworzono lub edytowano z pomocą AI. Facebook pokazuje na poście etykietę „AI info”. Działa dla każdego posta VIDEO, niezależnie od postType: Facebook publikuje każdy film jako Reela, a relacja wideo też ma tę etykietę. Zdjęcia, karuzele i posty tekstowe są odrzucane błędem 400.
videoTitlestringTytuł postów wideo (maks. 255 znaków)
textFormatPresetIdstringTło Facebooka dla posta tekstowego jako numeryczne id Facebooka (106018623298955 to jednolity fiolet). Tylko posty TEXT, bez multimediów, do 130 znaków; wszystko inne zwraca 400. Linki są wyświetlane bez podglądu, a jeśli Facebook odrzuci tło, post ukazuje się jako zwykły tekst
imageLayoutstringGRID (domyślnie) pokazuje kilka obrazów jako siatkę zdjęć. CAROUSEL pokazuje je jako przewijane karty, każdą z własnym linkiem. Karuzela wymaga od 2 do 5 obrazów, bez filmów, postType FEED i jednego wpisu carouselCards na obraz; wszystko inne zwraca 400
carouselCardsarrayJedna karta na obraz, w kolejności multimediów, używana przy imageLayout CAROUSEL. Każda karta ma link (wymagany, http lub https), title (do 100 znaków) i description (do 200). Facebook pokazuje obraz i tytuł tylko dla linków do witryny należącej do Strony; przy innym linku post kończy się niepowodzeniem z podaniem przyczyny

LinkedIn

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
documentTitlestringTytuł wyświetlany w poście DOCUMENT (maks. 100 znaków). Domyślnie nazwa pliku; ignorowany dla innych typów treści
reshareOfstringPost na LinkedIn do ponownego udostępnienia, z tekstem posta jako komentarzem: URN urn:li:share: lub urn:li:ugcPost: albo adres URL posta na LinkedIn, który go zawiera, np. /feed/update/urn:li:share:7123/ lub link Embed posta (maks. 500 znaków). Multimedia nie są dołączane na tym koncie; inne platformy w poście nadal je otrzymują. URN aktywności lub adres /posts/...-activity-... zwraca 400
Przykład
{
  "contentType": "DOCUMENT",
  "mediaUrls": ["https://cdn.adaptlypost.com/.../q3-results.pdf"],
  "linkedinConnectionIds": ["conn_li_001"],
  "linkedinConfigs": [{
    "connectionId": "conn_li_001",
    "documentTitle": "Q3 results"
  }]
}

X (Twitter)

Konto X może cytować własne posty. X odrzuca cytowanie postów innych kont, dlatego quoteOf musi wskazywać post tego samego konta. Konto cytujące publikuje tylko tekst, bez multimediów.

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
quoteOfstringCytowany post: jego link, np. https://x.com/yourhandle/status/1234567890 (działają też linki twitter.com, mobilne i /i/web/status/), lub jego numeryczne ID (maks. 200 znaków). Link do posta innego konta zwraca 400 z X_QUOTE_NOT_OWN_POST, wartość niebędąca postem X zwraca X_QUOTE_INVALID, a cytat bez tekstu zwraca X_QUOTE_TEXT_REQUIRED. Multimedia nie są dołączane na tym koncie; inne platformy w poście nadal je otrzymują, a odpowiedzi w wątku są publikowane pod cytatem
Przykład
{
  "contentType": "TEXT",
  "text": "A year later, still the best decision we made.",
  "twitterConnectionIds": ["conn_x_001"],
  "twitterConfigs": [{
    "connectionId": "conn_x_001",
    "quoteOf": "https://x.com/yourhandle/status/1234567890"
  }]
}

Google Business Profile

Google Business Profile przyjmuje posty TEXT lub IMAGE z jednym obrazem JPEG lub PNG do 5 MB i tekstem do 1500 znaków. Nie obsługuje tekstu alternatywnego. Lokalizacja bez konfiguracji publikuje aktualność STANDARD.

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
topicTypeWYMAGANEstringSTANDARD, EVENT lub OFFER. EVENT i OFFER wymagają eventTitle, eventStart i eventEnd
callToActionTypestringBOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP lub CALL. CALL używa numeru telefonu z profilu firmy
callToActionUrlstringAdres, do którego prowadzi przycisk. Wymagany dla każdego przycisku poza CALL
eventTitlestringTytuł wydarzenia lub oferty
eventStartstringPoczątek w czasie lokalnym firmy, jako YYYY-MM-DD lub YYYY-MM-DDTHH:mm, bez strefy czasowej
eventEndstringKoniec w czasie lokalnym firmy, jako YYYY-MM-DD lub YYYY-MM-DDTHH:mm, bez strefy czasowej
offerCouponCodestringKod kuponu wyświetlany w ofercie
offerRedeemUrlstringLink, pod którym klienci mogą skorzystać z oferty
offerTermsstringWarunki oferty
Przykład
{
  "googleBusinessConfigs": [{
    "connectionId": "conn_gbp_001",
    "topicType": "EVENT",
    "eventTitle": "Live music night",
    "eventStart": "2026-10-16T19:00",
    "eventEnd": "2026-10-16T23:00",
    "callToActionType": "LEARN_MORE",
    "callToActionUrl": "https://example.com/events/live-music"
  }]
}

Tumblr

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
tagsstring[]Do 30 tagów, każdy do 140 znaków, bez przecinków. Początkowy znak # jest usuwany
titlestringNagłówek nad postem, do 4096 znaków
sourceUrlstringLink http lub https podany jako źródło, do 2048 znaków
Przykład
{
  "tumblrConfigs": [{
    "connectionId": "conn_tumblr_001",
    "title": "Studio notes, week 12",
    "tags": ["art process", "sketchbook"],
    "sourceUrl": "https://example.com/blog/studio-notes"
  }]
}

WordPress

Tekst posta staje się treścią opublikowanego wpisu na blogu. Id kategorii można znaleźć przez GET /api/v1/social-accounts/:id/wordpress-categories (zob. Konta społecznościowe). Witryna bez konfiguracji używa pierwszego wiersza tekstu jako tytułu i umieszcza post w kategorii domyślnej. Status DRAFT zostawia na witrynie wersję roboczą do dokończenia i opublikowania lub zaplanowania w WordPressie, a PENDING przesyła ją do weryfikacji.

ParametrTypOpis
connectionIdWYMAGANEstringId konta z /social-accounts, którego dotyczy ta konfiguracja
titlestringTytuł posta, do 300 znaków. Pominięcie powoduje użycie pierwszego wiersza tekstu, skróconego do 100 znaków
excerptstringStreszczenie wyświetlane przez WordPress na listach wpisów i w kanałach, do 1000 znaków
categoryIdsnumber[]Do 50 id kategorii witryny. Pominięcie umieszcza post w kategorii domyślnej witryny
tagsstring[]Do 50 nazw tagów, każda do 100 znaków. Tag, którego witryna jeszcze nie ma, jest tworzony, jeśli użytkownik WordPress może zarządzać tagami, a w przeciwnym razie pomijany
statusstringPUBLISH (domyślnie) publikuje post. DRAFT zapisuje go jako wersję roboczą na witrynie, a PENDING przesyła do weryfikacji; w obu przypadkach adres URL posta na platformie otwiera go w edytorze WordPress
Przykład
{
  "wordpressConfigs": [{
    "connectionId": "conn_wp_001",
    "title": "What we shipped in October",
    "excerpt": "Bulk scheduling, a new calendar view and faster uploads.",
    "categoryIds": [12],
    "tags": ["product updates", "release notes"],
    "status": "DRAFT"
  }]
}