
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.
Publikuj jako
Northwind Bakery
Anna 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
POST
posts
PATCHposts/{id}
DELETEposts/{id}
200 OK
Spis treści
API Meta
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
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.
Utwórz postWyślij
POST /v2/{account_id}/postsz kluczem wX-API-KEYoraz tekstem lub załącznikami.Edytuj, usuń lub publikuj jako StronaWywołaj
PATCHlubDELETEna poście albo dodajpost_asz 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.
{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_list2
Uprawnienia
Poproś o prawa do publikacji, a potem przejdź App Review.
pages_manage_posts3
Token Strony
Uzyskaj token Strony z tokena użytkownika.
GET /me/accounts4
Publikacja
Opublikuj na osi czasu Strony z tokenem Strony.
POST /{page_id}/feedUprawnienia i zadania na Stronie
- Publikacja. Dokumentacja Page feed wymaga
pages_manage_posts,pages_read_engagementipages_show_list, od osoby, która może wykonać na Stronie zadanieCREATE_CONTENT. - Zarządzanie postami i ich zaangażowaniem. Przewodnik Pages API po postach dodaje
pages_manage_engagementipages_read_user_engagement, z zadaniamiCREATE_CONTENT,MANAGEiMODERATE. - 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
| Parametr | Do czego służy |
|---|---|
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 |
message
Tekst posta
link
URL wyświetlany z podglądem linku
published
false dla posta nieopublikowanego lub zaplanowanegoscheduled_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 przypadek | Zasada |
|---|---|
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 |
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 textcan_read
anyone (domyślnie) lub relations_onlycan_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.
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/, 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.
Nie mogę się doczekać dołączenia do zespołu w Lizbonie w przyszłym miesiącu!
Slajdy z mojego wystąpienia o narzędziach supportu są już online.
Weekendowa wędrówka z zespołem.
Następna strona
next_cursor: "QVFIUm..."
GET
v2/{ACCOUNT_ID}/users/{USER_ID}/posts
200 OK
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.
| Kryterium | Meta Pages API | Połączone konto (Unipile) |
|---|---|---|
| Obsługiwane konta | Strony zarządzane przez użytkowników Twojej aplikacji | Profil użytkownika i Strony, którymi zarządza |
| Konfiguracja po Twojej stronie | Aplikacja Meta, Facebook Login, App Review | Klucz API i Hosted Auth, bez App Review |
| Dane uwierzytelniające | Jeden token na Stronę | Jedno account_id na użytkownika |
| Posty na profilu osobistym | Niedostępne od 2018 | Tak, jako połączony użytkownik |
| Edycja postów | Tylko posty utworzone Twoją aplikacją | Tekst posta, po post_id |
| Grupy | Wycofane w v19.0 | Nieobsługiwane |
| Stories | Poza zakresem tego przewodnika | Nieobsługiwane |
| Planowanie | scheduled_publish_time, od 10 minut do 30 dni | Nieudokumentowane, użyj własnej kolejki zadań |
| Inne sieci | Tylko Strony na Facebooku | To 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żytkownikaPosty 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_idGrupy
Meta Pages APIWycofane w v19.0
Połączone kontoNieobsługiwane
Stories
Meta Pages APIPoza zakresem tego przewodnika
Połączone kontoNieobsługiwane
Planowanie
Meta Pages API
scheduled_publish_time, od 10 minut do 30 dniPołą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.
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
