For AI agents: the full index of these docs is at https://adaptlypost.com/pl/docs/llms.txt. Every docs page is also available as Markdown: append .md to its URL or request it with the header Accept: text/markdown.
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
Parametr
Typ
Opis
connectionIdWYMAGANE
string
Id konta z /social-accounts, którego dotyczy ta konfiguracja
title
string
Posty ze zdjęciami: tytuł wyświetlany nad opisem. Posty wideo: wysyłany jako podpis tylko wtedy, gdy caption jest puste. Maks. 90 znaków
caption
string
Posty 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
Id konta z /social-accounts, którego dotyczy ta konfiguracja
postType
string
VIDEO lub SHORTS
videoTitle
string
Tytuł filmu (maks. 100 znaków)
tags
string[]
Tagi filmu ułatwiające wyszukiwanie (maks. 20)
privacyStatus
string
public, unlisted lub private
categoryId
string
ID kategorii YouTube
playlistId
string
Dodaje do playlisty po przesłaniu
notifySubscribers
boolean
Powiadamia subskrybentów (domyślnie true)
allowEmbedding
boolean
Zezwala na osadzanie w innych witrynach
madeForKids
boolean
Oznacza jako przeznaczone dla dzieci
aiGenerated
boolean
Ujawnia 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.
license
string
youtube lub creativeCommon
defaultAudioLanguage
string | null
Ję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
scheduleOnYouTube
boolean
Przesył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
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.
Parametr
Typ
Opis
connectionIdWYMAGANE
string
Id konta z /social-accounts, którego dotyczy ta konfiguracja
boardId
string
ID 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
boardName
string
Nazwa 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
Id konta z /social-accounts, którego dotyczy ta konfiguracja
postType
string
FEED, 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
shareToStory
boolean
Publikuje 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
trialGraduation
string
Publikuje 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ąć
collaborators
string[]
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.
userTags
object[]
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.
aiGenerated
boolean
Ujawnia, ż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ę.
audio
InstagramAudio
Muzyka 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
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.
Parametr
Typ
Opis
audioIdWYMAGANE
string
audioId z wyszukiwania dźwięków
title
string
Tytuł utworu, zapisywany tylko do wyświetlania (maks. 255 znaków)
artist
string
Wykonawca lub twórca, zapisywany tylko do wyświetlania (maks. 255 znaków)
audioVolume
number
Głośność dodanego dźwięku, od 1 do 100 (domyślnie 100)
videoVolume
number
Głośność własnego dźwięku filmu, od 1 do 100 (domyślnie 100)
Facebook
Parametr
Typ
Opis
pageIdWYMAGANE
string
Strona na Facebooku, której dotyczy ta konfiguracja, tak jak wysłano w pageIds
postType
string
FEED, 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
shareToStory
boolean
Publikuje 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
aiGenerated
boolean
Ujawnia, ż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.
videoTitle
string
Tytuł postów wideo (maks. 255 znaków)
textFormatPresetId
string
Tł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
imageLayout
string
GRID (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
carouselCards
array
Jedna 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
Parametr
Typ
Opis
connectionIdWYMAGANE
string
Id konta z /social-accounts, którego dotyczy ta konfiguracja
documentTitle
string
Tytuł wyświetlany w poście DOCUMENT (maks. 100 znaków). Domyślnie nazwa pliku; ignorowany dla innych typów treści
reshareOf
string
Post 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
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.
Parametr
Typ
Opis
connectionIdWYMAGANE
string
Id konta z /social-accounts, którego dotyczy ta konfiguracja
quoteOf
string
Cytowany 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.
Parametr
Typ
Opis
connectionIdWYMAGANE
string
Id konta z /social-accounts, którego dotyczy ta konfiguracja
topicTypeWYMAGANE
string
STANDARD, EVENT lub OFFER. EVENT i OFFER wymagają eventTitle, eventStart i eventEnd
callToActionType
string
BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP lub CALL. CALL używa numeru telefonu z profilu firmy
callToActionUrl
string
Adres, do którego prowadzi przycisk. Wymagany dla każdego przycisku poza CALL
eventTitle
string
Tytuł wydarzenia lub oferty
eventStart
string
Początek w czasie lokalnym firmy, jako YYYY-MM-DD lub YYYY-MM-DDTHH:mm, bez strefy czasowej
eventEnd
string
Koniec w czasie lokalnym firmy, jako YYYY-MM-DD lub YYYY-MM-DDTHH:mm, bez strefy czasowej
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.
Parametr
Typ
Opis
connectionIdWYMAGANE
string
Id konta z /social-accounts, którego dotyczy ta konfiguracja
title
string
Tytuł posta, do 300 znaków. Pominięcie powoduje użycie pierwszego wiersza tekstu, skróconego do 100 znaków
excerpt
string
Streszczenie wyświetlane przez WordPress na listach wpisów i w kanałach, do 1000 znaków
categoryIds
number[]
Do 50 id kategorii witryny. Pominięcie umieszcza post w kategorii domyślnej witryny
tags
string[]
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
status
string
PUBLISH (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" }]
}