Listado de publicaciones de una página de Facebook mediante la API: feed, posts y published_posts
Las publicaciones de una Página de Facebook se leen de tres edges de la Graph API: /{page-id}/feed devuelve el feed de la Página, incluidas las publicaciones de visitantes y las públicas que etiquetan la Página; /{page-id}/posts devuelve las publicaciones propias de la Página, y /{page-id}/published_posts devuelve las publicadas. Una petición devuelve hasta 100 publicaciones, las páginas siguientes llegan por cursor, y Meta devuelve unas 600 publicaciones publicadas y ordenadas por ranking al año.
easyCoexistence lista las publicaciones recientes de una Página de Facebook con list_social_posts desde Claude, ChatGPT o tu propio código, hasta 100 por llamada.
Máximo de publicaciones que una petición puede leer con limit; pedir más devuelve un error.
Publicaciones publicadas y ordenadas por ranking que la API devuelve al año al leer las publicaciones de una Página.
Campo que distingue las publicaciones publicadas de las no publicadas, que el edge feed devuelve juntas.
El edge de la Página que la referencia de feed de Meta señala para listar los Reels publicados en una Página.
Enlace de paginación que hay que seguir hasta que deje de aparecer; una página corta o vacía no marca el final.
Las publicaciones propias de la Página, que la referencia de Página de Meta describe como un derivado del edge /feed.
¿Cuál es la diferencia entre feed, posts y published_posts?
Quién escribió la publicación y si ya está publicada. La referencia de Páginas de Meta describe así los tres edges principales y tres más específicos, y el feed también devuelve publicaciones no publicadas junto a las publicadas, que is_published distingue:
¿Qué campos conviene pedir?
Indícalos en fields: el ejemplo de lectura de publicaciones de una Página de Meta devuelve id, created_time y message. Su referencia de Page Post los incluye entre los campos de una publicación:
- id, message y
created_time: la publicación, su texto y cuándo se publicó. permalink_url: la dirección permanente de la publicación en facebook.com.full_picture: la imagen a tamaño completo de su adjunto.status_type,is_publishedyscheduled_publish_time.- shares, con el número de veces que se compartió la publicación.
- attachments, comments y reactions, que son edges y no campos simples.
¿Cómo se obtienen los recuentos de reacciones y comentarios?
Con expansión de campos en la lectura de publicaciones. reactions.summary(total_count) añade el número de reacciones, y Meta indica que los recuentos de Me gusta incluyen care. shares trae su propio recuento. El edge comments devuelve total_count al pedir summary, que según Meta puede superar los comentarios devueltos, por privacidad o por eliminaciones.
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25¿Cómo funciona la paginación?
Por cursor. Cada respuesta incluye paging, con los cursores before y after y los enlaces next y previous; sigue next hasta que deje de aparecer. Meta advierte que no hay que tomar una página con menos resultados que limit como el final, ya que una página puede incluso estar vacía y aun así traer next. Los cursores pueden quedar inválidos rápidamente al añadir o eliminar elementos, así que para un rango al que vuelves, usa since y until.
¿Qué límites se aplican?
La referencia de feed de Meta establece estos para leer las publicaciones de una Página:
- 100 publicaciones por petición con limit; un valor mayor devuelve un error que pide no superar 100.
- Unas 600 publicaciones publicadas y ordenadas por ranking al año.
- El contenido de una publicación caducada ya no puede consultarse por la Graph API.
- Listar publicaciones de video exige que quien hace la petición sea administrador de la Página.
- Una publicación que comparte la de otra persona puede no ser visible si el original no lo es para el token usado.
- Los datos de las personas aparecen en las respuestas solo cuando la petición usa un token de acceso de Página.
¿Dónde se listan los Reels y las historias?
En edges propios. El edge de feed de Meta señala el edge video_reels de la Página para los Reels publicados en ella, y GET /{page-id}/video_reels los lista con since y until. GET /{page-id}/stories lista las historias de la Página como PUBLISHED o ARCHIVED, estas últimas solo mientras el archivo de historias de la Página esté activado.
¿Qué devuelve list_social_posts para una Página?
Las publicaciones recientes de la Página desde /{page-id}/posts, 25 por defecto y hasta 100 por llamada, cada una con id, message, created_time, permalink_url y full_picture, junto con los cursores de paginación de Meta. No pide recuentos y lee una página de resultados: list_social_comments lee los comentarios de una publicación, y get_social_insights lee las métricas de una publicación con su ID como object_id.
¿Cómo se listan las publicaciones hechas a través de easyCoexistence?
Con list_scheduled_posts, que lista las publicaciones hechas a través de easyCoexistence, publicadas ahora o programadas: las próximas primero, por estado, o una por post_id. Cada una trae su estado (scheduled, publishing, processing, published, failed o canceled), publish_at, su enlace una vez en línea y el error si falló. La pantalla de Publicaciones del panel las muestra en Requiere atención, Próximas y Publicadas.
Errores comunes
- Esperar recuentos de list_social_posts. Lee texto, fecha, enlace e imagen; las métricas de una publicación salen de get_social_insights con su ID como object_id.
- Leer /feed para las publicaciones propias de la Página. También devuelve las de visitantes, las públicas que etiquetan la Página y las no publicadas; usa /published_posts o filtra por is_published.
- Tomar una página corta como la última. Detente solo cuando desaparezca el enlace next, ya que Meta indica que una página puede estar vacía y aun así tenerlo.
- Guardar cursores para más tarde. Meta indica que pueden quedar inválidos rápidamente al añadir o eliminar publicaciones; guarda los valores since y until.
list_scheduled_posts sigue lo que salió a través de easyCoexistence. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que agregas conexiones, y los primeros 3 días gratis.
Preguntas frecuentes
¿El edge de feed incluye publicaciones programadas?
Devuelve publicadas y no publicadas juntas, así que lee is_published para distinguirlas, o usa GET /{page-id}/scheduled_posts para las que están programadas para más tarde.
¿La API puede listar las publicaciones de otra Página?
Solo con la función Page Public Content Access de Meta y un token de acceso de usuario. easyCoexistence lee las Páginas que conectas, con sus propios tokens de Página.
¿Cómo obtengo publicaciones de un rango de fechas?
Añade since y until a la lectura, como marcas de tiempo UNIX o valores de strtotime; la guía de paginación de Meta recomienda ambos para obtener resultados consistentes.
¿Cuánto cuesta easyCoexistence para una Página de Facebook?
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que agregas conexiones, y los primeros 3 días gratis; cada Página conectada es una conexión.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el