REST APIGET

Kanały RSS

Podłącz kanał RSS lub Atom i zamieniaj każdy nowy wpis w szkic, zaplanowany post lub opublikowany post na wybranych kontach, z szablonem albo opisami AI.

Uprawnienie: posts.read. Zobacz Role i uprawnienia.

Wyświetlanie i odczyt kanałów oraz ich wpisów wymagają posts.read. Tworzenie, podgląd, aktualizacja, wstrzymywanie, wznawianie, sprawdzanie i usuwanie wymagają posts.draft oraz uprawnienia potrzebnego w trybie publikacji kanału: posts.schedule dla SCHEDULE, posts.publish dla PUBLISH i ai.generate dla opisów AI. Aktualizacja, wstrzymanie, wznowienie, sprawdzenie lub usunięcie kanału skonfigurowanego przez innego członka wymaga też posts.others.

Kanał jest sprawdzany według harmonogramu, a każdy wpis, który pojawi się po jego dodaniu, staje się postem na kontach z targets. Każdy post przechodzi te same kontrole co Utwórz post. Kanał publikuje jako członek, który zapisał go ostatni: utworzenie, aktualizacja lub wznowienie kanału czyni jego właścicielem członka powiązanego z kluczem.

MetodaŚcieżkaOpis
GET/api/v1/rss-feedsLista kanałów obszaru roboczego, od najnowszych
POST/api/v1/rss-feedsPodłączenie kanału
POST/api/v1/rss-feeds/previewPobranie kanału bez zapisywania i renderowanie 5 najnowszych wpisów
GET/api/v1/rss-feeds/:idPobranie jednego kanału
PATCH/api/v1/rss-feeds/:idZmiana wysłanych pól. Adresu URL nie można zmienić
DELETE/api/v1/rss-feeds/:idZakończenie sprawdzania kanału. Utworzone już posty pozostają
GET/api/v1/rss-feeds/:id/itemsLista wpisów, które kanał napotkał
POST/api/v1/rss-feeds/:id/pauseWstrzymanie kanału
POST/api/v1/rss-feeds/:id/resumeUsunięcie powodu wstrzymania i sprawdzenie kanału w ciągu minuty
POST/api/v1/rss-feeds/:id/checkPrzesunięcie sprawdzenia na teraz; kanał zostanie pobrany w ciągu minuty

POST /api/v1/rss-feeds

Pobiera kanał i zapisuje wszystkie wpisy, które już się w nim znajdują, więc publikowane są tylko te, które pojawią się później. Obszar roboczy może mieć do 20 kanałów.

PoleTypWymaganeOpis
urlstringTakPubliczny adres URL http lub https kanału RSS albo Atom
targetsarrayTakOd 1 do 20 kont, każde jako { platform, connectionId, pageId }. connectionId to id konta z Konta społecznościowe, a pageId jest wymagane dla FACEBOOK
postModestringTakDRAFT tworzy szkic. SCHEDULE planuje post na publishDelayMinutes po wykryciu wpisu. PUBLISH publikuje go od razu
contentModestringTakTEMPLATE wypełnia template. AI pisze jeden opis na platformę na podstawie artykułu, dodaje link i zużywa 1 kredyt AI na platformę za każdy wpis
namestringNieDo 120 znaków. Domyślnie tytuł kanału
publishDelayMinutesintegerNieOd 5 do 10080 (7 dni). Wymagane, gdy postMode to SCHEDULE
templatestringNieTekst posta z {title}, {link}, {description}, {author} i {feed}, do 2000 znaków. Domyślnie {title}\n\n{link}. Opis, a potem tytuł, są skracane do limitu każdej platformy; link nigdy nie jest ucinany
aiInstructionsstringNieDodatkowe instrukcje dla opisów AI, do 1000 znaków
includeImagebooleanNieDołącza obraz wpisu albo obraz podglądu artykułu. Domyślnie true
twitterKeepLinksbooleanNieZachowuje klikalne linki w postach na X. Tylko w planach lifetime, a każdy post na X z linkiem kosztuje wtedy więcej kredytów. Domyślnie false
includeKeywordsstring[]NieDo 50. Publikuje tylko wpisy, których tytuł lub streszczenie zawiera jedno z nich
excludeKeywordsstring[]NieDo 50. Pomija wpisy, których tytuł lub streszczenie zawiera jedno z nich
maxPostsPerCheckintegerNieOd 1 do 10, domyślnie 3. Nowe wpisy są publikowane od najstarszych; pozostałe czekają na kolejne sprawdzenie
checkIntervalMinutesintegerNie15, 30, 60, 180, 360, 720 lub 1440. Domyślnie 60
postLatestItembooleanNiePublikuje też najnowszy wpis przy pierwszym sprawdzeniu. Domyślnie false

Celami mogą być FACEBOOK, INSTAGRAM, THREADS, TWITTER, BLUESKY, LINKEDIN, MASTODON, TELEGRAM i GOOGLE_BUSINESS.

Przykładowe żądanie:

{
  "url": "https://blog.example.com/feed.xml",
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001" },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345" }
  ],
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "New on the blog: {title}\n\n{link}",
  "excludeKeywords": ["sponsored"]
}

Zwraca 201 z kanałem:

{
  "id": "rss_01j9x",
  "userId": "user_123",
  "accountGroupId": "ag_01j9x",
  "name": "Example Blog",
  "url": "https://blog.example.com/feed.xml",
  "siteUrl": "https://blog.example.com",
  "status": "ACTIVE",
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "New on the blog: {title}\n\n{link}",
  "includeImage": true,
  "twitterKeepLinks": false,
  "includeKeywords": [],
  "excludeKeywords": ["sponsored"],
  "maxPostsPerCheck": 3,
  "checkIntervalMinutes": 60,
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001", "displayName": "Example Inc." },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345", "displayName": "Example" }
  ],
  "nextCheckAt": "2026-11-08T15:00:00.000Z",
  "createdAt": "2026-11-08T14:00:00.000Z",
  "updatedAt": "2026-11-08T14:00:00.000Z"
}

Adres URL, który nie jest kanałem RSS ani Atom, kanał już podłączony, nieobsługiwana platforma docelowa, brak publishDelayMinutes lub przekroczenie limitu 20 kanałów zwraca 400. Kanał, z którym nie można się połączyć, zwraca 503. Klucz bez uprawnienia wymaganego przez tryb publikacji lub opisy AI zwraca 403.

Pola kanału

PoleOpis
userIdCzłonek, jako który publikuje kanał: ten, kto zapisał go ostatni
statusACTIVE lub PAUSED
pauseReasonPowód wstrzymania, ustawiony tylko, gdy kanał ma status PAUSED. Zobacz tabelę poniżej
lastErrorBłąd, który spowodował wstrzymanie, jeśli przyczyną była awaria
targets[].displayNameNazwa konta uzupełniana przez AdaptlyPost. Wysłana wartość jest ignorowana
nextCheckAt, lastCheckedAt, lastPostedAtKiedy nastąpi kolejne sprawdzenie, kiedy było ostatnie i kiedy kanał ostatnio utworzył post

Pozostałe pola zawierają opisane wyżej ustawienia.

Powód wstrzymaniaZnaczenie
USERKtoś wstrzymał kanał przez API lub w aplikacji
FETCH_FAILURES5 kolejnych pobrań się nie powiodło
CONSECUTIVE_FAILURES3 kolejnych wpisów nie udało się opublikować
ACCESS_LOSTWłaściciel stracił uprawnienie wymagane przez tryb publikacji
SUBSCRIPTION_INACTIVEPlan nie obejmuje już publikowania
CONNECTION_REMOVEDWszystkie konta docelowe zostały odłączone

Usuń przyczynę, a potem wznów kanał.

POST /api/v1/rss-feeds/preview

Przyjmuje url i opcjonalny template, pobiera kanał bez zapisywania czegokolwiek i zwraca url, title, siteUrl oraz 5 najnowszych items, każdy z title, link, summary, publishedAt, imageUrl i text, czyli wpisem wyrenderowanym według szablonu.

GET /api/v1/rss-feeds/:id/items

Wyświetla wpisy, które kanał napotkał, od najnowszych, z pominięciem tych, które były w nim już w chwili dodania. limit przyjmuje wartości od 1 do 100, domyślnie 20. Zwraca { "items": [...] }, każdy z id, title, link, publishedAt, createdAt, status, postId i error.

Status wpisuZnaczenie
BASELINEBył już w kanale w chwili jego dodania
PROCESSINGTrwa zamiana w post
POSTEDStał się postem. postId wskazuje ten post
FILTEREDOdrzucony przez reguły słów kluczowych
SKIPPEDOpublikowany ponad 14 dni przed dodaniem kanału
FAILEDNie udało się utworzyć posta. error podaje przyczynę

Aktualizacja, wstrzymanie, wznowienie, sprawdzenie i usunięcie

PATCH przyjmuje te same pola co tworzenie, z wyjątkiem url i postLatestItem, i zmienia tylko te, które wyślesz. Wstrzymanie, wznowienie, sprawdzenie i usunięcie nie przyjmują treści żądania. Każde z nich oprócz usunięcia zwraca kanał; usunięcie zwraca { "deleted": true }. Identyfikator, który nie istnieje lub należy do innego obszaru roboczego, zwraca 404.