Pobieranie postów strony na Facebooku przez API: feed, posts i published_posts
Posty strony na Facebooku odczytuje się z trzech krawędzi (edge) Graph API: /{page-id}/feed zwraca feed strony, łącznie z postami odwiedzających i publicznymi postami oznaczającymi stronę, /{page-id}/posts zwraca własne posty strony, a /{page-id}/published_posts zwraca jej opublikowane posty. Jedno żądanie zwraca do 100 postów, kolejne strony pobiera się kursorem, a Meta zwraca około 600 rankingowych, opublikowanych postów w ciągu roku.
easyCoexistence wylicza ostatnie posty strony na Facebooku przez list_social_posts z poziomu Claude, ChatGPT lub własnego kodu, do 100 na wywołanie.
Najwięcej postów, jakie jedno żądanie może odczytać z użyciem limit; żądanie o więcej zwraca błąd.
Rankingowe, opublikowane posty w ciągu roku, jakie API zwraca przy odczytywaniu postów strony.
Pole, które odróżnia opublikowane posty od nieopublikowanych, a które krawędź feed zwraca razem.
Krawędź strony, na którą wskazuje dokumentacja feedu Meta, do wyświetlania Reels opublikowanych na stronie.
Link do kolejnej strony, który należy śledzić, aż przestanie się pojawiać; krótka lub pusta strona nie oznacza końca.
Własne posty strony, które dokumentacja Meta opisuje jako pochodną krawędzi /feed.
Czym różnią się feed, posts i published_posts?
Tym, kto napisał post i czy został już opublikowany. Dokumentacja Strony w Meta opisuje w ten sposób trzy główne krawędzie i trzy węższe, a feed zwraca również nieopublikowane posty obok opublikowanych; odróżnia je is_published:
Które pola warto zażądać?
Wymień je w fields: przykładowy odczyt postów strony od Meta zwraca id, created_time i message. Jego dokumentacja Page Post wymienia wśród pól posta:
- id, message i
created_time: post, jego tekst i czas publikacji. permalink_url: stały adres posta na facebook.com.full_picture: zdjęcie w pełnym rozmiarze z załącznika.status_type,is_publishedischeduled_publish_time.- shares, z liczbą udostępnień posta.
- attachments, comments i reactions, które są krawędziami, a nie zwykłymi polami.
Jak uzyskać liczbę reakcji i komentarzy?
Przez rozwinięcie pól przy odczycie postów. reactions.summary(total_count) dodaje liczbę reakcji, a Meta zaznacza, że liczba polubień obejmuje także care. shares ma własny licznik. Krawędź comments zwraca total_count, gdy zażądano summary; Meta mówi, że może ona przekraczać liczbę zwróconych komentarzy z powodu prywatności lub usunięcia.
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25Jak działa stronicowanie?
Kursorem. Każda odpowiedź zawiera paging, z kursorami before i after oraz linkami next i previous; podążaj za next, aż przestanie się pojawiać. Meta ostrzega, by nie traktować strony z mniejszą liczbą wyników niż limit jako końca, bo strona może być nawet pusta i nadal zawierać next. Kursory mogą szybko stać się nieważne, gdy elementy są dodawane lub usuwane, więc dla zakresu, do którego będziesz wracać, użyj since i until.
Jakie obowiązują limity?
Dokumentacja feedu Meta ustala dla odczytu postów strony:
- 100 postów na żądanie przy użyciu limit; większa wartość zwraca błąd z prośbą, by nie przekraczać 100.
- Około 600 rankingowych, opublikowanych postów w ciągu roku.
- Treści wygasłego posta nie można już wyświetlić przez Graph API.
- Wylistowanie postów wideo wymaga, by osoba wykonująca żądanie była administratorem strony.
- Post udostępniający czyjś może być niewidoczny, jeśli oryginał nie jest widoczny dla użytego tokenu.
- Dane osób pojawiają się w odpowiedziach tylko wtedy, gdy żądanie używa tokenu dostępu strony.
Gdzie wylistować Reels i stories?
W osobnych krawędziach. Dokumentacja feedu Meta wskazuje krawędź video_reels strony dla Reels opublikowanych na stronie, a GET /{page-id}/video_reels wylicza je z parametrami since i until. GET /{page-id}/stories wylicza stories strony jako PUBLISHED lub ARCHIVED, przy czym zarchiwizowane tylko wtedy, gdy archiwum stories strony jest włączone.
Co list_social_posts zwraca dla strony?
Ostatnie posty strony z /{page-id}/posts, domyślnie 25, a maksymalnie 100 na wywołanie, każdy z id, message, created_time, permalink_url i full_picture, wraz z kursorami stronicowania Meta. Nie zwraca liczników i odczytuje jedną stronę wyników: list_social_comments odczytuje komentarze posta, a get_social_insights odczytuje metryki posta z jego ID jako object_id.
Jak wylistować posty utworzone przez easyCoexistence?
Za pomocą list_scheduled_posts, który wylicza posty utworzone przez easyCoexistence, opublikowane od razu lub zaplanowane: nadchodzące, najbliższe najpierw, według statusu albo po post_id. Każdy ma status (scheduled, publishing, processing, published, failed lub canceled), publish_at, link po publikacji oraz błąd, jeśli się nie udało. Ekran Posts w panelu grupuje je jako Needs attention, Coming up i Published.
Typowe błędy
- Oczekiwanie liczników od list_social_posts. Odczytuje on tekst, czas, link i zdjęcie; metryki posta pochodzą z get_social_insights z jego ID jako object_id.
- Odczytywanie /feed dla własnych postów strony. Zwraca on także posty odwiedzających, publiczne posty oznaczające stronę i nieopublikowane; użyj /published_posts albo filtruj po is_published.
- Traktowanie krótkiej strony jako ostatniej. Zatrzymaj się dopiero, gdy link next zniknie, bo Meta mówi, że strona może być pusta i mieć jeden.
- Zapisywanie kursorów na później. Meta mówi, że mogą szybko stać się nieważne, gdy posty są dodawane lub usuwane; zachowaj zamiast tego wartości since i until.
list_scheduled_posts śledzi to, co wyszło przez easyCoexistence. Cena: US$ 9 do US$ 0.75 za połączenie miesięcznie, spadająca wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Czy krawędź feed zawiera zaplanowane posty?
Zwraca opublikowane i nieopublikowane posty razem, więc odczytaj is_published, aby je odróżnić, albo GET /{page-id}/scheduled_posts dla tych zaplanowanych na później.
Czy API może wylistować posty innej strony?
Tylko z funkcją Page Public Content Access od Meta i tokenem dostępu użytkownika. easyCoexistence odczytuje strony, które podłączysz, ich własnymi tokenami strony.
Jak pobrać posty z zakresu dat?
Dodaj since i until do odczytu, jako znaczniki czasu UNIX lub wartości strtotime; przewodnik Meta po stronicowaniu zaleca oba, aby wyniki były spójne.
Ile kosztuje easyCoexistence dla strony na Facebooku?
Cena: US$ 9 do US$ 0.75 za połączenie miesięcznie, spadająca wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni; każda podłączona strona to jedno połączenie.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w