API ile Facebook Sayfası gönderilerini listeleme: feed, posts ve published_posts
Bir Facebook Sayfasının gönderileri üç Graph API edge'inden okunur: /{page-id}/feed sayfanın akışını döndürür; buna ziyaretçilerin gönderileri ve sayfayı etiketleyen herkese açık gönderiler de dahildir. /{page-id}/posts sayfanın kendi gönderilerini, /{page-id}/published_posts ise yayımlanmış olanlarını döndürür. Bir istek en fazla 100 gönderi döndürür, sonraki sayfalar cursor ile gelir ve Meta yılda yaklaşık 600 sıralanmış, yayımlanmış gönderi döndürür.
easyCoexistence, Claude, ChatGPT ya da kendi kodunuzdan list_social_posts ile bir Facebook Sayfasının son gönderilerini listeler; çağrı başına en fazla 100 tane.
limit ile bir istekte okunabilecek en fazla gönderi sayısı; daha fazlasını istemek hata döndürür.
Bir Sayfanın gönderilerini okurken API'nin döndürdüğü, yılda sıralanmış yayımlanmış gönderi sayısı.
Yayımlanmış ile yayımlanmamış gönderileri ayıran alan; feed edge'i bunları birlikte döndürür.
Meta'nın feed referansının, bir Sayfaya yayımlanan Reels'leri listelemek için işaret ettiği Page edge'i.
Artık görünmeyene kadar takip edilecek sayfalama bağlantısı; kısa ya da boş bir sayfa sonun işareti değildir.
Meta'nın Page referansında /feed edge'inin türevi olarak tanımlanan Sayfanın kendi gönderileri.
feed, posts ve published_posts arasındaki fark nedir?
Gönderiyi kimin yazdığı ve yayımlanıp yayımlanmadığı. Meta'nın Page referansı üç ana edge'i ve üç daha dar olanı bu şekilde tanımlar; feed ayrıca yayımlanmamış gönderileri de döndürür ve bunları is_published alanı yayımlanmışlardan ayırır:
Hangi alanları istemeye değer?
Alanları fields içinde adlandırın: Meta'nın bir Sayfanın gönderilerini okuma örneği id, created_time ve message ile birlikte döner. Page Post referansı, bir gönderinin alanları arasında şunları listeler:
- id, message ve
created_time: gönderi, metni ve yayımlandığı zaman. permalink_url: gönderinin facebook.com üzerindeki kalıcı adresi.full_picture: ekindeki tam boyutlu görsel.status_type,is_publishedvescheduled_publish_time.- shares: gönderinin kaç kez paylaşıldığını gösteren sayı.
- attachments, comments ve reactions: düz alanlar değil, edge'lerdir.
Tepki ve yorum sayıları nasıl alınır?
Gönderileri okurken alan genişletmesiyle. reactions.summary(total_count) tepki sayısını ekler ve Meta, beğeni sayılarına care tepkisinin dahil olduğunu belirtir. shares kendi sayısını taşır. summary istendiğinde comments edge'i total_count döndürür; Meta bunun, gizlilik ya da silme nedeniyle döndürülen yorumlardan fazla olabileceğini söyler.
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25Sayfalama nasıl çalışır?
cursor ile. Her yanıt paging içerir; bunda before ve after cursor'ları ile next ve previous bağlantıları bulunur. next artık görünmeyene kadar takip edin. Meta, limit değerinden az sonuç içeren bir sayfayı sonun işareti saymamanızı uyarır; bir sayfa boş bile olsa next taşıyabilir. Cursor'lar gönderiler eklendikçe ya da silindikçe hızla geçersiz olabilir; bu yüzden tekrar döneceğiniz bir aralık için since ve until kullanın.
Hangi sınırlar geçerlidir?
Meta'nın feed referansı, bir Sayfanın gönderilerini okumak için şu sınırları koyar:
- limit ile istek başına 100 gönderi; daha büyük bir değer, 100'ü aşmamanızı isteyen bir hata döndürür.
- Yılda yaklaşık 600 sıralanmış, yayımlanmış gönderi.
- Süresi dolmuş bir gönderinin içeriği artık Graph API üzerinden görüntülenemez.
- Video gönderilerini listelemek için isteği yapan kişinin Sayfanın yöneticisi olması gerekir.
- Başkasının gönderisini paylaşan bir gönderi, orijinal kullanılan token'a görünmüyorsa görünmeyebilir.
- Kişilerin bilgileri, yanıtlarda yalnızca istek bir Sayfa erişim token'ı kullandığında görünür.
Reels ve hikayeler nerede listelenir?
Kendi edge'lerinde. Meta'nın feed referansı, bir Sayfaya yayımlanan Reels için Sayfanın video_reels edge'ini gösterir; GET /{page-id}/video_reels bunları since ve until ile listeler. GET /{page-id}/stories, Sayfanın hikayelerini PUBLISHED ya da ARCHIVED olarak listeler; arşivlenmiş olanlar yalnızca Sayfanın hikaye arşivi açıkken görünür.
list_social_posts bir Sayfa için ne döndürür?
/{page-id}/posts üzerinden Sayfanın son gönderileri; varsayılan olarak 25, çağrı başına en fazla 100 tane. Her biri id, message, created_time, permalink_url ve full_picture ile birlikte gelir; Meta'nın sayfalama cursor'ları da döndürülür. Sayıları istemez ve tek bir sonuç sayfası okur: list_social_comments bir gönderinin yorumlarını okur, get_social_insights ise bir gönderinin metriklerini, kimliği object_id olarak verilerek okur.
easyCoexistence üzerinden yapılan gönderileri nasıl listelerim?
list_scheduled_posts ile. Bu araç, easyCoexistence üzerinden oluşturulan gönderileri, şimdi yayımlanan ya da planlanmış olanları listeler: yaklaşanlar en yakından başlayarak, durumuna göre ya da post_id ile tek tek. Her biri durumunu (scheduled, publishing, processing, published, failed ya da canceled), publish_at değerini, yayına girdiğinde bağlantısını ve başarısız olduysa hatasını taşır. Panelin Gönderiler ekranı bunları Dikkat gerektirenler, Yaklaşanlar ve Yayımlananlar altında gösterir.
Yaygın hatalar
- list_social_posts'tan sayı beklemek. Metin, zaman, bağlantı ve görseli okur; bir gönderinin metrikleri, kimliği object_id olarak verilerek get_social_insights'tan gelir.
- Sayfanın kendi gönderileri için /feed okumak. Bu edge ziyaretçilerin gönderilerini, sayfayı etiketleyen herkese açık gönderileri ve yayımlanmamış olanları da döndürür; /published_posts kullanın ya da is_published ile filtreleyin.
- Kısa bir sayfayı son sayfa saymak. Yalnızca next bağlantısı kaybolduğunda durun; Meta bir sayfanın boş olup yine de next taşıyabileceğini söyler.
- Cursor'ları ileride kullanmak üzere saklamak. Meta, gönderiler eklendikçe ya da silindikçe bunların hızla geçersiz olabileceğini söyler; bunun yerine since ve until değerlerini saklayın.
list_scheduled_posts, easyCoexistence üzerinden gönderilenleri takip eder. Bağlantı başına ayda US$ 9'dan US$ 0.75'e, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Feed edge'i zamanlanmış gönderileri içerir mi?
Yayımlanmış ve yayımlanmamış gönderileri birlikte döndürür; bu yüzden ayırt etmek için is_published alanını okuyun ya da daha sonraya ayarlanmış olanlar için GET /{page-id}/scheduled_posts çağırın.
API başka bir Sayfanın gönderilerini listeleyebilir mi?
Yalnızca Meta'nın Page Public Content Access özelliği ve bir Kullanıcı erişim token'ı ile. easyCoexistence, bağlantısını kurduğunuz Sayfaları kendi Sayfa token'larıyla okur.
Bir tarih aralığındaki gönderileri nasıl alırım?
Okumaya since ve until ekleyin; UNIX zaman damgası ya da strtotime değeri olarak. Meta'nın sayfalama rehberi, tutarlı sonuçlar için ikisini birlikte önerir.
easyCoexistence bir Facebook Sayfası için ne kadar tutar?
Bağlantı başına ayda US$ 9'dan US$ 0.75'e, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir. Bağlanan her Sayfa bir bağlantıdır.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi