PL
Przewodnik dla programistów

Facebook Post API: publikuj, edytuj i odczytuj posty ze swojej aplikacji

Publikowanie, edycja, usuwanie i odczyt postów na Facebooku przez API w 2026 roku, przez Pages API od Meta lub własne połączone konta Twoich użytkowników.

Twoja aplikacja Połączono
Publikuj jakoFacebookNorthwind BakeryFacebookAnna Lee
Świeży chleb na zakwasie codziennie od 7:00. Zamówienia przyjmujemy od piątku.
Opublikuj
Nasze jesienne menu startuje w poniedziałekNorthwind Bakery · Strona · DziśOpublikowano
Dziękujemy za 10 wspaniałych lat!Northwind Bakery · Strona · 2 paźEdytowano
Wracam z targuAnna Lee · Prywatne · 28 wrzW koszu
POSTposts PATCHposts/{id} DELETEposts/{id} 200 OK
Krótka odpowiedź

Facebook post API pozwala aplikacji publikować, edytować, usuwać i odczytywać posty na Facebooku za pomocą żądań HTTP. Są dwie drogi: Pages API od Meta, które publikuje tylko na Stronach na Facebooku przez aplikację Meta i Page access tokeny, albo połączone konto, w którym każdy użytkownik łączy własne konto Facebook, a Twoja aplikacja publikuje jako jego profil lub jako Strona, którą zarządza.

Szerszy obraz platformy Meta pokazuje, jak współgrają ze sobą API Facebooka.

Z Unipile

Opublikuj post na Facebooku w trzech krokach

  1. Połącz kontoTwój użytkownik łączy swoje konto Facebook oraz zarządzane przez siebie Strony przez Hosted Auth. Bez aplikacji Meta i bez App Review.

  2. Utwórz postWyślij POST /v2/{account_id}/posts z kluczem w X-API-KEY oraz tekstem lub załącznikami.

  3. Edytuj, usuń lub publikuj jako StronaWywołaj PATCH lub DELETE na poście albo dodaj post_as z ID aktywowanej Strony.

Definicja

Czym jest Facebook Post API?

Meta nie ma produktu o nazwie „Post API”. Posty na Facebooku to obiekty Graph API, a aplikacje publikują je przez Pages API, które zapisuje tylko na Stronach na Facebooku. Od 2018 roku aplikacja zewnętrzna nie może już publikować na profilu osobistym.

W praktyce „Facebook post API”, czyli to, co programiści nazywają API Facebook do postów, oznacza wywołania Graph API na węźle posta i na krawędzi /feed Strony. Węzły, krawędzie i tokeny omawiamy w przeglądzie Facebook Graph API.

Facebook Posty w Graph API
{page_id}_{post_id}Węzeł posta. Jego ID łączy ID autora i ID posta.
/{page_id}/feedKrawędź, która listuje posty Strony i przyjmuje nowe.
messageTekst posta.
created_timeData publikacji posta.
/{page_id}/photosKrawędź dla postów ze zdjęciami.
Meta Pages API

Jak opublikować post na Stronie na Facebooku przez Graph API?

Wyślij POST /{page_id}/feed z polem message (i opcjonalnie link), używając Page access tokena (zobacz przewodnik Facebook Page API i nasz przewodnik token dostępu API Facebook). Meta zwraca ID nowego posta jako {"id": "{page_post_id}"}.

1

Aplikacja Meta

Utwórz aplikację i dodaj Facebook Login for Business.

pages_show_list
2

Uprawnienia

Poproś o prawa do publikacji, a potem przejdź App Review.

pages_manage_posts
3

Token Strony

Uzyskaj token Strony z tokena użytkownika.

GET /me/accounts
4

Publikacja

Opublikuj na osi czasu Strony z tokenem Strony.

POST /{page_id}/feed

Uprawnienia i zadania na Stronie

  • Publikacja. Dokumentacja Page feed wymaga pages_manage_posts, pages_read_engagement i pages_show_list, od osoby, która może wykonać na Stronie zadanie CREATE_CONTENT.
  • Zarządzanie postami i ich zaangażowaniem. Przewodnik Pages API po postach dodaje pages_manage_engagement i pages_read_user_engagement, z zadaniami CREATE_CONTENT, MANAGE i MODERATE.
  • Wideo. Dodaj publish_video.

Żądanie i odpowiedź znajdziesz w zakładkach Meta cURL i Meta Python bloku kodu poniżej, obok wersji Unipile.

Parametry posta Strony

ParametrDo czego służy
messageTekst posta
linkURL wyświetlany z podglądem linku
publishedfalse dla posta nieopublikowanego lub zaplanowanego
scheduled_publish_timeData publikacji, od 10 minut do 30 dni naprzód
message
Tekst posta
link
URL wyświetlany z podglądem linku
published
false dla posta nieopublikowanego lub zaplanowanego
scheduled_publish_time
Data publikacji, od 10 minut do 30 dni naprzód

Zdjęcia i wideo. Pojedyncze zdjęcie trafia do /{page_id}/photos. W przypadku posta z wieloma zdjęciami prześlij każde zdjęcie do tej krawędzi z published=false, a potem opublikuj je razem w /{page_id}/feed z attached_media i zwróconymi ID; nieopublikowane zdjęcia są usuwane po 24 godzinach. Filmy przechodzą przez Video API z publish_video.

Źródło: od Meta Pages API posts documentation, Pages API getting started, Page feed reference oraz Page photos reference (Graph API v27.0). Ostatnia weryfikacja: 17 listopada 2026.

Zasady publikacji

Czego API Meta nie pozwala robić z postami

Trzy zasady Graph API wyznaczają ramy każdego projektu publikacji na Facebooku: aplikacje nie mogą publikować na profilach osobistych ani w Grupach i mogą aktualizować tylko te posty Stron, które same utworzyły.

Od 2018

Brak postów na profilach osobistych

Meta odebrała aplikacjom uprawnienie publish_actions 1 sierpnia 2018 roku. Szczegóły w części o ograniczeniach oficjalnego API Facebook.

Od 2024

Brak postów w Grupach

Groups API i publish_to_groups zostały wycofane wraz z Graph API v19.0 23 stycznia 2024 roku.

Często pomijane

Edycja tylko postów z własnej aplikacji

„Aplikacja może zaktualizować post Strony tylko wtedy, gdy został utworzony za pomocą tej aplikacji”.

Twoja aplikacja nie może zaktualizować posta napisanego na facebook.com lub w innym narzędziu, więc produkt, który edytuje posty, musi je tworzyć.

Błędy, które napotkasz najpierw. W Graph API kod 190 oznacza, że token dostępu wygasł, kody od 200 do 299 oznaczają, że uprawnienie nie zostało przyznane lub zostało odebrane, a 4 lub 17 oznaczają zbyt wiele wywołań. W Unipile publikacja jako Strona, która nie jest aktywowana, zwraca 403 api/insufficient_permissions.

Źródła: od Meta Pages API posts documentation, Facebook Login changelog, Graph API v19.0 announcement oraz Graph API error handling. Ostatnia weryfikacja: 17 listopada 2026.

Z Unipile

Publikuj, edytuj i usuwaj posty z połączonego konta

Z Unipile każdy użytkownik łączy swoje konto Facebook przez Hosted Auth, a Twoja aplikacja otrzymuje account_id. Post tworzysz przez POST /v2/{account_id}/posts, zmieniasz jego tekst przez PATCH, a usuwasz przez DELETE. Usunięty post trafia do kosza, gdzie autor może go jeszcze czytać przez 30 dni.

Bez aplikacji Meta i App Review po Twojej stronie: każde wywołanie przesyła Twój klucz API w X-API-KEY i działa w imieniu użytkownika, który połączył konto. Zakładki Meta pokazują dla porównania tę samą publikację przez Graph API z Page access tokenem.

const BASE = "https://api.unipile.com/v2";
const headers = {
  "X-API-KEY": process.env.UNIPILE_API_KEY,
  "content-type": "application/json"
};

// 1. Publish a text post from the connected account
await fetch(`${BASE}/${ACCOUNT_ID}/posts`, {
  method: "POST", headers,
  body: JSON.stringify({ text: "Our autumn menu starts Monday." })
});

// 2. Edit its text later (media and audience are kept)
await fetch(`${BASE}/${ACCOUNT_ID}/posts/${POST_ID}`, {
  method: "PATCH", headers,
  body: JSON.stringify({ text: "Our autumn menu starts Monday at 7am." })
});
import os, requests

BASE = "https://api.unipile.com/v2"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}

# 1. Publish a text post from the connected account
requests.post(f"{BASE}/{ACCOUNT_ID}/posts", headers=headers,
              json={"text": "Our autumn menu starts Monday."})

# 2. Edit its text later (media and audience are kept)
requests.patch(f"{BASE}/{ACCOUNT_ID}/posts/{POST_ID}", headers=headers,
               json={"text": "Our autumn menu starts Monday at 7am."})
# 1. Publish a text post from the connected account
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Our autumn menu starts Monday." }'

# 2. Edit its text later (media and audience are kept)
curl --request PATCH \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts/{POST_ID}" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Our autumn menu starts Monday at 7am." }'
# Meta Graph API: publish to a Page with a Page access token
curl -X POST "https://graph.facebook.com/v27.0/{PAGE_ID}/feed" \
  -H "Content-Type: application/json" \
  -d '{
        "message": "Our autumn menu starts Monday.",
        "link": "https://example.com/menu",
        "access_token": "{PAGE_ACCESS_TOKEN}"
      }'

# Response: the ID of the new Page post
{ "id": "{PAGE_POST_ID}" }

# Read that post back with the fields you need
curl -G "https://graph.facebook.com/v27.0/{PAGE_POST_ID}" \
  -d "fields=id,message,created_time,permalink_url" \
  -d "access_token={PAGE_ACCESS_TOKEN}"
import os, requests

GRAPH = "https://graph.facebook.com/v27.0"
TOKEN = os.environ["PAGE_ACCESS_TOKEN"]

# Meta Graph API: publish to a Page
r = requests.post(f"{GRAPH}/{PAGE_ID}/feed", data={
    "message": "Our autumn menu starts Monday.",
    "link": "https://example.com/menu",
    "access_token": TOKEN,
})
post_id = r.json()["id"]  # {"id": "{PAGE_POST_ID}"}

# Read that post back with the fields you need
post = requests.get(f"{GRAPH}/{post_id}", params={
    "fields": "id,message,created_time,permalink_url",
    "access_token": TOKEN,
}).json()

Pola żądania opisuje Create posts, a edycję i kosz Edit and delete posts. Zakładki Meta są zgodne z Pages API posts guide i Post reference, v27.0, weryfikacja 17 listopada 2026.

Zasady treści posta na Facebooku

Pole lub przypadekZasada
text i attachmentsWymagany tekst lub załącznik. Pliki w base64 albo multipart dla dużych plików
ZdjęciaKilka zdjęć tworzy album
WideoJedno wideo na post, nigdy razem ze zdjęciami
quoted_post_idUdostępnia post, bez załączników
Oznaczenia@ plus ID lub nazwa profilu (vanity name) w text
can_readanyone (domyślnie) lub relations_only
can_commentTylko anyone, w przeciwnym razie 400
text i attachments
Wymagany tekst lub załącznik. Pliki w base64 albo multipart dla dużych plików
Zdjęcia
Kilka zdjęć tworzy album
Wideo
Jedno wideo na post, nigdy razem ze zdjęciami
quoted_post_id
Udostępnia post, bez załączników
Oznaczenia
@ plus ID lub nazwa profilu (vanity name) w text
can_read
anyone (domyślnie) lub relations_only
can_comment
Tylko anyone, w przeciwnym razie 400
Zgodność

Twoi użytkownicy publikują z własnych kont

Unipile nie jest produktem Meta ani Meta Partner. Twoi użytkownicy łączą własne konta, decydują, co zostanie opublikowane, i nadal obowiązują ich warunki Meta.

Strony na Facebooku

Jak publikować jako Strona na Facebooku z połączonego konta?

Dodaj post_as z ID Strony, którą konto administruje i która jest na nim aktywowana. Nie trzeba łączyć osobnego konta: to samo account_id obejmuje profil użytkownika i jego Strony.

  • Znajdź ID Strony. Każda aktywowana Strona ma skrzynkę o nazwie PAGE_<page_id>_INBOX.
  • Najpierw aktywuj Stronę. Publikacja jako nieaktywowana Strona zwraca 403 api/insufficient_permissions.
  • Edycja podąża za autorem. Post napisany przez aktywowaną Stronę jest edytowany lub usuwany jako ta Strona, bez dodatkowego pola.

Kroki konfiguracji opisuje dokumentacja Facebook Pages.

Publikuj jako Facebook
Anna LeeBez post_as: publikuje jako profilProfil
Northwind Bakerypost_as: "1357020157484056"Aktywowana
Harbor CafeStrona nieaktywowana403
POST /v2/{account_id}/posts
{
  "text": "Hello from our Page!",
  "post_as": "1357020157484056"
}
Odczyt postów

Jak pobrać posty z profilu lub Strony na Facebooku?

W API Meta wywołaj GET /{page_id}/feed z Page access tokenem. W Unipile wywołaj GET /v2/{account_id}/users/{user_id}/posts, gdzie user_id to me, ID aktywowanej Strony albo ID innej osoby lub Strony, której posty połączone konto już widzi na Facebooku.

Typowe zastosowanie: ostatnia aktywność w CRM lub narzędziu do social mediów, dla kont połączonych przez Twoich użytkowników. Odczyt cudzych postów ogranicza się do tego, co połączone konto już widzi na Facebooku, i odbywa się na prośbę użytkownika.

Julia Chen · Najnowsze posty Facebook

Nie mogę się doczekać dołączenia do zespołu w Lizbonie w przyszłym miesiącu!

2 dni temu41

Slajdy z mojego wystąpienia o narzędziach supportu są już online.

30 paź18

Weekendowa wędrówka z zespołem.

21 paź27
Następna stronanext_cursor: "QVFIUm..."
GET v2/{ACCOUNT_ID}/users/{USER_ID}/posts 200 OK
Meta

Przez Graph API Meta

Endpoint
GET/{page_id}/feed
Token
Page access token
Zadanie na Stronie
Właściciel tokena potrzebuje na Stronie CREATE_CONTENT, MANAGE lub MODERATE
Uprawnienia
pages_read_engagement i pages_read_user_content
Wolumen
Maksymalnie 100 postów na żądanie z limit i około 600 rankingowanych, opublikowanych postów rocznie
Jeden post
GET /{post_id}, z wybranymi fields, np. message, created_time lub permalink_url (zobacz zakładki Meta powyżej)
Posty użytkownika
/{user_id}/posts z User access tokenem i user_posts: tylko posty na własnej osi czasu tego użytkownika i posty, na których jest oznaczony

Źródła: dokumentacja Page feed, Post i User posts, v27.0, weryfikacja 17 listopada 2026.

Unipile

Przez Unipile

Lista postów
GET/v2/{account_id}/users/{user_id}/posts
user_id
me, ID aktywowanej Strony albo ID innej osoby lub Strony, w granicach postów, które połączone konto już widzi
Jeden post
GET/v2/{account_id}/posts/{post_id}
ID posta
<author id>_<post id>
Reakcje i komentarze
Listowanie, dodawanie i usuwanie reakcji pod postem oraz praca z jego komentarzami (zobacz API komentarzy Facebook), przez to samo account_id
Paginację narzuca Facebook

Facebook zwraca do 3 postów na stronę, niezależnie od wysłanego limit. Aby pobrać kolejną stronę, użyj next_cursor; nie ma parametru offset. Szczegóły w List user posts.

Decyzja

Pages API czy połączone konta: co pasuje do Twojego produktu?

Pages API od Meta pasuje do aplikacji, która publikuje na własnych Stronach firmowych lub na Stronach klientów przechodzących przez Twoją aplikację Meta. Połączone konto pasuje do produktu SaaS, w którym każdy użytkownik publikuje z własnego profilu i Stron, bez aplikacji Meta po Twojej stronie.

KryteriumMeta Pages APIPołączone konto (Unipile)
Obsługiwane kontaStrony zarządzane przez użytkowników Twojej aplikacjiProfil użytkownika i Strony, którymi zarządza
Konfiguracja po Twojej stronieAplikacja Meta, Facebook Login, App ReviewKlucz API i Hosted Auth, bez App Review
Dane uwierzytelniająceJeden token na StronęJedno account_id na użytkownika
Posty na profilu osobistymNiedostępne od 2018Tak, jako połączony użytkownik
Edycja postówTylko posty utworzone Twoją aplikacjąTekst posta, po post_id
GrupyWycofane w v19.0Nieobsługiwane
StoriesPoza zakresem tego przewodnikaNieobsługiwane
Planowaniescheduled_publish_time, od 10 minut do 30 dniNieudokumentowane, użyj własnej kolejki zadań
Inne sieciTylko Strony na FacebookuTo samo API dla LinkedIn, Instagrama, WhatsApp i innych
Obsługiwane konta
Meta Pages APIStrony zarządzane przez użytkowników Twojej aplikacji
Połączone kontoProfil użytkownika i Strony, którymi zarządza
Konfiguracja po Twojej stronie
Meta Pages APIAplikacja Meta, Facebook Login, App Review
Połączone kontoKlucz API i Hosted Auth, bez App Review
Dane uwierzytelniające
Meta Pages APIJeden token na Stronę
Połączone kontoJedno account_id na użytkownika
Posty na profilu osobistym
Meta Pages APINiedostępne od 2018
Połączone kontoTak, jako połączony użytkownik
Edycja postów
Meta Pages APITylko posty utworzone Twoją aplikacją
Połączone kontoTekst posta, po post_id
Grupy
Meta Pages APIWycofane w v19.0
Połączone kontoNieobsługiwane
Stories
Meta Pages APIPoza zakresem tego przewodnika
Połączone kontoNieobsługiwane
Planowanie
Meta Pages APIscheduled_publish_time, od 10 minut do 30 dni
Połączone kontoNieudokumentowane, użyj własnej kolejki zadań
Inne sieci
Meta Pages APITylko Strony na Facebooku
Połączone kontoTo samo API dla LinkedIn, Instagrama, WhatsApp i innych

To samo połączenie obejmuje rozmowy: zobacz API Facebook i Messenger od Unipile, jak połączyć prywatne konto Facebook oraz cennik Facebook Messenger API.

Zastosowania

Zastosowania: posty w CRM, narzędziach social media i agentach AI

Facebook post API sprawdza się w produktach, w których ludzie już pracują, a każdy użytkownik publikuje z własnych kont.

Skrzynki social media i narzędzia dla community

Community managerowie publikują i poprawiają posty na swoim profilu i Stronach, obok wiadomości.

Aktywność w CRM

Na prośbę handlowca karta kontaktu pokazuje najnowsze posty danej osoby, w granicach tego, co połączone konto handlowca już widzi na Facebooku.

Agenci AI z zatwierdzaniem

Agent przygotowuje szkic posta, użytkownik go zatwierdza i dopiero wtedy Twoja aplikacja wysyła POST.

Ten sam model postów działa w innych sieciach: nasz przewodnik po API Instagram omawia drugą sieć Meta.

Zacznij publikować posty na Facebooku ze swojej aplikacji

Do własnych Stron używaj Pages API od Meta. Gdy każdy użytkownik publikuje, edytuje i odczytuje posty z własnego profilu i Stron, połącz ich konta przez Unipile: jedno REST API.

Komisja Europejska
Regulowane przez UE Digital Markets Act (DMA)

Każdy użytkownik łączy własne konto, bez przechowywania profili. Unipile nie jest partnerem Meta. Dowiedz się więcej

Wszystkie endpointy API Facebooka w jednym miejscu

Posty to tylko część całości. Zobacz wszystkie endpointy Facebooka dostępne w Unipile, od wiadomości po profile, lub przeczytaj kompletny przewodnik po API Facebook.

Facebook Post API: FAQ

Szybkie odpowiedzi o Stronach, zdjęciach, planowaniu, edycji, Grupach, wideo i odczycie postów.

W Pages API od Meta wyślij POST /{page_id}/feed z polem message, używając Page access tokena i uprawnień pages_manage_posts, pages_read_engagement i pages_show_list. W Unipile użytkownik raz łączy swoje konto Facebook, a Ty wywołujesz POST /v2/{account_id}/posts z post_as ustawionym na ID Strony, którą zarządza i którą aktywował.

W Unipile kilka zdjęć w jednym poście wyświetla się jako album, a zamiast nich post może zawierać jedno wideo, nigdy oba naraz. W Pages API od Meta zdjęcia publikuje się przez krawędź /{page_id}/photos.

Pages API od Meta to umożliwia: utwórz post z published ustawionym na false i scheduled_publish_time od 10 minut do 30 dni naprzód, zgodnie z przewodnikiem Pages API (Page feed reference podaje 75 dni; przetestuj na swojej wersji). Unipile nie dokumentuje natywnego planowania, więc przechowuj zaplanowaną datę we własnej kolejce zadań i wywołaj POST /v2/{account_id}/posts, gdy nadejdzie termin.

Tak. W API Meta aplikacja może aktualizować tylko posty Stron, które sama utworzyła, a post usuwa przez DELETE /{page_post_id}. W Unipile PATCH /v2/{account_id}/posts/{post_id} zmienia tekst, a DELETE przenosi post do kosza, gdzie autor może go czytać przez 30 dni.

Nie. Meta wycofała Groups API i uprawnienie publish_to_groups wraz z Graph API v19.0 w styczniu 2024 roku, a Unipile również nie obsługuje publikacji w Grupach.

Wideo tak. W Unipile post przyjmuje jedno wideo, które Facebook przetwarza asynchronicznie. Reels nie są udokumentowane, a Stories nie są obsługiwane.

W Graph API Meta wywołaj GET /{page_id}/feed z Page access tokenem i uprawnieniami pages_read_engagement i pages_read_user_content; limit zwraca maksymalnie 100 postów na żądanie. W Unipile wywołaj GET /v2/{account_id}/users/{user_id}/posts z ID aktywowanej Strony, a następnie użyj next_cursor, aby pobrać kolejną stronę.

Nie. Unipile to niezależna firma, a nie Meta Partner, i nie jest wspierana, sponsorowana ani zatwierdzona przez Meta. Posty publikowane przez Twoją aplikację pochodzą z własnych kont i Stron Twoich użytkowników na Facebooku. Facebook jest znakiem towarowym Meta Platforms, Inc.

Nie. Aby publikować lub odczytywać posty przez Unipile, Twoi użytkownicy łączą własne konto Facebook i Strony, którymi zarządzają, przez hostowane uwierzytelnianie. Pomijasz aplikację Meta, uprawnienia do publikacji i App Review, których wymaga ścieżka Pages API.

Unipile zostało zaprojektowane w duchu Digital Markets Act: każdy użytkownik łączy własne konto i decyduje, co zostanie opublikowane, a Unipile działa w jego imieniu bez przechowywania profili użytkowników. Więcej na naszej stronie o Digital Markets Act.

Tak. Każdy post publikowany lub odczytywany przez Twoją aplikację przechodzi przez konto, które nadal podlega Warunkom korzystania z usług Meta. Trzymaj się uzasadnionych zastosowań, takich jak publikowanie własnych treści użytkowników i pokazywanie postów, które ich konto już widzi, gdy o to poproszą; spam i nieautoryzowana automatyzacja mogą skutkować ograniczeniem kont.

Masz jeszcze pytania? Nasz zespół chętnie pomoże.

Porozmawiaj z ekspertem