Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

100

Najwięcej postów, jakie jedno żądanie może odczytać z użyciem limit; żądanie o więcej zwraca błąd.

About 600

Rankingowe, opublikowane posty w ciągu roku, jakie API zwraca przy odczytywaniu postów strony.

is_published

Pole, które odróżnia opublikowane posty od nieopublikowanych, a które krawędź feed zwraca razem.

video_reels

Krawędź strony, na którą wskazuje dokumentacja feedu Meta, do wyświetlania Reels opublikowanych na stronie.

next

Link do kolejnej strony, który należy śledzić, aż przestanie się pojawiać; krótka lub pusta strona nie oznacza końca.

posts

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:

feedThe Page's feed: its own posts and links, visitors' posts and public posts tagging it
postsThe Page's own posts, a derivative of /feed
published_postsPublished posts by the Page
scheduled_postsPosts the Page scheduled to a future date
visitor_postsPublic posts published by visitors on the Page
taggedPhotos, videos and posts in which the Page is tagged

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_published i scheduled_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.

Reading posts with share and reaction counts
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25

Jak 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.
Z EasyCoexistence zrobisz to

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