ES
Guía para desarrolladores

API de publicaciones de Facebook: publicar, editar y leer publicaciones desde su app

Publicar, editar, eliminar y leer publicaciones de Facebook por API en 2026, con la Pages API de Meta o con las cuentas conectadas de sus propios usuarios.

Su app Conectada
Publicar comoFacebookNorthwind BakeryFacebookAnna Lee
Pan de masa madre recién hecho cada mañana desde las 7 h. Reservas abiertas el viernes.
Publicar
Nuestro menú de otoño llega el lunesNorthwind Bakery · Página · HoyPublicada
¡Gracias por 10 años increíbles!Northwind Bakery · Página · 2 oct.Editada
De vuelta del mercadoAnna Lee · Personal · 28 sept.En la papelera
POSTposts PATCHposts/{id} DELETEposts/{id} 200 OK
Respuesta corta

Una API de publicaciones de Facebook permite a su app publicar, editar, eliminar y leer publicaciones de Facebook mediante peticiones HTTP. Hay dos vías: la Pages API de Meta, que solo publica en Páginas de Facebook a través de una app de Meta y de Page access tokens, o una cuenta conectada, en la que cada usuario vincula su propia cuenta de Facebook y su app publica como su perfil o como una Página que gestiona.

Para una visión más amplia de la plataforma de Meta, consulte cómo encajan las API de Facebook.

Con Unipile

Publique en Facebook en tres pasos

  1. Conectar la cuentaSu usuario vincula su cuenta de Facebook, y las Páginas que gestiona, mediante Hosted Auth. Sin app de Meta ni App Review.

  2. Crear la publicaciónEnvíe POST /v2/{account_id}/posts con su clave en X-API-KEY y un texto o archivos adjuntos.

  3. Editar, eliminar o publicar como PáginaLlame a PATCH o DELETE sobre la publicación, o añada post_as con el ID de una Página activada.

Definición

¿Qué es la API de publicaciones de Facebook?

Meta no tiene ningún producto llamado "Post API". Las publicaciones de Facebook son objetos de la Graph API, y las apps las publican a través de la Pages API, que solo escribe en Páginas de Facebook. Desde 2018, una app de terceros ya no puede publicar en el perfil propio de una persona.

En la práctica, "API de publicaciones de Facebook", o lo que los desarrolladores llaman la API de Facebook para publicar, designa las llamadas a la Graph API sobre un nodo de publicación y sobre el edge /feed de una Página. Nodos, edges y tokens: consulte nuestra presentación de la Graph API de Facebook.

Facebook Publicaciones en la Graph API
{page_id}_{post_id}El nodo de la publicación. Su ID une el ID del autor y el de la publicación.
/{page_id}/feedEl edge que lista las publicaciones de una Página y recibe las nuevas.
messageEl texto de la publicación.
created_timeCuándo se publicó.
/{page_id}/photosEl edge de las publicaciones con fotos.
Meta Pages API

¿Cómo se publica en una Página de Facebook con la Graph API?

Envíe POST /{page_id}/feed con un message (y, opcionalmente, un link), usando un Page access token (consulte la guía de la API de Páginas de Facebook y nuestra guía sobre el token de acceso de la API de Facebook). Meta devuelve el ID de la nueva publicación en la forma {"id": "{page_post_id}"}.

1

App de Meta

Cree una app y añada Facebook Login for Business.

pages_show_list
2

Permisos

Solicite los derechos de publicación y supere el App Review.

pages_manage_posts
3

Token de Página

Obtenga el token de Página a partir del user token.

GET /me/accounts
4

Publicar

Publique en el feed de la Página con el token de Página.

POST /{page_id}/feed

Permisos y tareas de Página

  • Para publicar. La referencia del feed de Página exige pages_manage_posts, pages_read_engagement y pages_show_list, por parte de alguien que pueda realizar la tarea CREATE_CONTENT en la Página.
  • Para gestionar las publicaciones y sus interacciones. La guía de publicaciones de la Pages API añade pages_manage_engagement y pages_read_user_engagement, con las tareas CREATE_CONTENT, MANAGE y MODERATE.
  • Para el vídeo. Añada publish_video.

La petición y su respuesta están en las pestañas Meta cURL y Meta Python del bloque de código de abajo, junto a la versión de Unipile.

Parámetros de una publicación de Página

ParámetroQué hace
messageEl texto de la publicación
linkUna URL mostrada con vista previa del enlace
publishedfalse para una publicación no publicada o programada
scheduled_publish_timeFecha de publicación, entre 10 minutos y 30 días después
message
El texto de la publicación
link
Una URL mostrada con vista previa del enlace
published
false para una publicación no publicada o programada
scheduled_publish_time
Fecha de publicación, entre 10 minutos y 30 días después

Fotos y vídeo. Una sola foto va a /{page_id}/photos. Para una publicación con varias fotos, suba cada foto a ese edge con published=false y publíquelas juntas en /{page_id}/feed con attached_media y los ID devueltos; las fotos no publicadas se eliminan pasadas 24 horas. Los vídeos pasan por la Video API con publish_video.

Fuente: de Meta, documentación de publicaciones de la Pages API, Pages API getting started, la referencia del feed de Página y la referencia de las fotos de Página (Graph API v27.0). Última verificación: 17 de noviembre de 2026.

Reglas de publicación

Lo que la API de Meta no permite hacer con las publicaciones

Tres reglas de la Graph API condicionan cualquier proyecto de publicación en Facebook: las apps no pueden publicar en perfiles personales ni en Grupos, y solo pueden modificar las publicaciones de Página que ellas mismas crearon.

Desde 2018

Nada de publicar en perfiles personales

Meta retiró a las apps el permiso publish_actions el 1 de agosto de 2018. Detalles en los límites de la API oficial de Facebook.

Desde 2024

Nada de publicar en Grupos

La Groups API y publish_to_groups quedaron obsoletos con la Graph API v19.0 el 23 de enero de 2024.

A menudo se pasa por alto

Solo se editan las publicaciones de su propia app

"Una app solo puede actualizar una publicación de Página si la publicación se hizo con esa app."

Su app no puede modificar una publicación escrita en facebook.com o con otra herramienta, así que un producto que edita publicaciones debe crearlas.

Los primeros errores que encontrará. Con la Graph API, el código 190 significa que el access token ha caducado, los códigos 200 a 299 indican que un permiso no se concedió o se retiró, y 4 o 17 indican demasiadas llamadas. Con Unipile, publicar como una Página que no está activada devuelve 403 api/insufficient_permissions.

Fuentes: de Meta, documentación de publicaciones de la Pages API, changelog de Facebook Login, anuncio de la Graph API v19.0 y gestión de errores de la Graph API. Última verificación: 17 de noviembre de 2026.

Con Unipile

Publicar, editar y eliminar publicaciones desde una cuenta conectada

Con Unipile, cada usuario conecta su cuenta de Facebook mediante Hosted Auth y su app obtiene un account_id. Se crea una publicación con POST /v2/{account_id}/posts, se modifica su texto con PATCH y se elimina con DELETE. Una publicación eliminada va a la papelera, donde su autor aún puede leerla durante 30 días.

Sin app de Meta ni App Review por su parte: cada llamada envía su API key en X-API-KEY y se ejecuta en nombre del usuario que conectó la cuenta. Las pestañas Meta muestran la misma publicación con la Graph API y un Page access token, para comparar.

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()

Los campos de la petición están en Create posts; la edición y la papelera, en Edit and delete posts. Las pestañas Meta siguen la guía de publicaciones de la Pages API y la referencia Post, v27.0, verificadas el 17 de noviembre de 2026.

Reglas de contenido de una publicación de Facebook

Campo o casoRegla
text y attachmentsTexto o adjunto obligatorio. Archivos en base64, o en multipart para los archivos grandes
ImágenesVarias imágenes forman un álbum
VídeoUn vídeo por publicación, nunca mezclado con imágenes
quoted_post_idComparte una publicación, sin adjuntos
Menciones@ más un ID o un nombre de usuario en text
can_readanyone (por defecto) o relations_only
can_commentSolo anyone; si no, 400
text y attachments
Texto o adjunto obligatorio. Archivos en base64, o en multipart para los archivos grandes
Imágenes
Varias imágenes forman un álbum
Vídeo
Un vídeo por publicación, nunca mezclado con imágenes
quoted_post_id
Comparte una publicación, sin adjuntos
Menciones
@ más un ID o un nombre de usuario en text
can_read
anyone (por defecto) o relations_only
can_comment
Solo anyone; si no, 400
Cumplimiento

Sus usuarios publican desde sus propias cuentas

Unipile no es un producto de Meta ni un Meta Partner. Sus usuarios conectan sus propias cuentas, deciden qué se publica y siguen sujetos a las condiciones de Meta.

Páginas de Facebook

¿Cómo se publica como Página de Facebook desde una cuenta conectada?

Añada post_as con el ID de una Página que la cuenta administre y que esté activada en la cuenta. No hay que conectar ninguna cuenta aparte: el mismo account_id cubre el perfil del usuario y sus Páginas.

  • Encuentre el ID de la Página. Cada Página activada tiene una bandeja llamada PAGE_<page_id>_INBOX.
  • Active primero la Página. Publicar como una Página no activada devuelve 403 api/insufficient_permissions.
  • Las ediciones siguen al autor. Una publicación escrita por una Página activada se edita o elimina como esa Página, sin ningún campo adicional.

Los pasos de configuración están en la documentación de Facebook Pages.

Publicar como Facebook
Anna LeeSin post_as: publica como el perfilPerfil
Northwind Bakerypost_as: "1357020157484056"Activada
Harbor CafePágina no activada403
POST /v2/{account_id}/posts
{
  "text": "Hello from our Page!",
  "post_as": "1357020157484056"
}
Leer publicaciones

¿Cómo se obtienen las publicaciones de un perfil o una Página de Facebook?

Con la API de Meta, llame a GET /{page_id}/feed con un Page access token. Con Unipile, llame a GET /v2/{account_id}/users/{user_id}/posts, donde user_id es me, el ID de una Página activada o el ID de otra persona o Página cuyas publicaciones la cuenta conectada ya puede ver en Facebook.

Uso típico: la actividad reciente en un CRM o una herramienta social, para las cuentas que conectaron sus usuarios. Leer las publicaciones de otra persona no va más allá de lo que la cuenta conectada ya ve en Facebook, y solo ocurre cuando el usuario lo solicita.

Julia Chen · Últimas publicaciones Facebook

¡Con muchas ganas de unirme al equipo de Lisboa el mes que viene!

Hace 2 días41

Ya están disponibles las diapositivas de mi charla sobre herramientas de soporte.

30 oct.18

Excursión de fin de semana con el equipo.

21 oct.27
Página siguientenext_cursor: "QVFIUm..."
GET v2/{ACCOUNT_ID}/users/{USER_ID}/posts 200 OK
Meta

Con la Graph API de Meta

Endpoint
GET/{page_id}/feed
Token
Page access token
Tarea de Página
El titular del token necesita CREATE_CONTENT, MANAGE o MODERATE en la Página
Permisos
pages_read_engagement y pages_read_user_content
Volumen
Como máximo 100 publicaciones por petición con limit, y unas 600 publicaciones publicadas y clasificadas por año
Una publicación
GET /{post_id}, eligiendo fields como message, created_time o permalink_url (vea las pestañas Meta de arriba)
Publicaciones de un usuario
/{user_id}/posts con un User access token y user_posts: solo las publicaciones de la propia biografía de ese usuario y aquellas en las que está etiquetado

Fuentes: referencias Page feed, Post y User posts, v27.0, verificadas el 17 de noviembre de 2026.

Unipile

Con Unipile

Listar publicaciones
GET/v2/{account_id}/users/{user_id}/posts
user_id
me, el ID de una Página activada o el ID de otra persona o Página, limitado a las publicaciones que la cuenta conectada ya puede ver
Una publicación
GET/v2/{account_id}/posts/{post_id}
ID de publicación
<author id>_<post id>
Reacciones y comentarios
Listar, añadir y quitar reacciones en una publicación, y gestionar sus comentarios (vea la API de comentarios de Facebook), con el mismo account_id
La paginación la fija Facebook

Facebook devuelve hasta 3 publicaciones por página, sea cual sea el limit que envíe. Siga next_cursor para obtener la página siguiente; no existe offset. Detalles en List user posts.

Decisión

Pages API o cuentas conectadas: ¿cuál encaja con su producto?

La Pages API de Meta encaja con una app que publica en las Páginas de su propia empresa, o en Páginas de clientes que pasan por su app de Meta. Una cuenta conectada encaja con un producto SaaS en el que cada usuario publica desde su propio perfil y sus Páginas, sin app de Meta por su parte.

CriterioPages API de MetaCuenta conectada (Unipile)
Cuentas cubiertasLas Páginas que gestionan los usuarios de su appEl perfil del usuario y las Páginas que gestiona
Configuración por su parteApp de Meta, Facebook Login, App ReviewAPI key y Hosted Auth, sin App Review
CredencialesUn token de Página por PáginaUn account_id por usuario
Publicaciones en el perfil personalNo disponible desde 2018Sí, como el usuario conectado
Edición de publicacionesSolo las publicaciones hechas con su appTexto de una publicación, por post_id
GruposObsoleta desde la v19.0No compatible
StoriesFuera del alcance de esta guíaNo compatible
Programaciónscheduled_publish_time, de 10 minutos a 30 díasNo documentada; use su propia cola de tareas
Otras redesSolo Páginas de FacebookLa misma API para LinkedIn, Instagram, WhatsApp y más
Cuentas cubiertas
Pages API de MetaLas Páginas que gestionan los usuarios de su app
Cuenta conectadaEl perfil del usuario y las Páginas que gestiona
Configuración por su parte
Pages API de MetaApp de Meta, Facebook Login, App Review
Cuenta conectadaAPI key y Hosted Auth, sin App Review
Credenciales
Pages API de MetaUn token de Página por Página
Cuenta conectadaUn account_id por usuario
Publicaciones en el perfil personal
Pages API de MetaNo disponible desde 2018
Cuenta conectadaSí, como el usuario conectado
Edición de publicaciones
Pages API de MetaSolo las publicaciones hechas con su app
Cuenta conectadaTexto de una publicación, por post_id
Grupos
Pages API de MetaObsoleta desde la v19.0
Cuenta conectadaNo compatible
Stories
Pages API de MetaFuera del alcance de esta guía
Cuenta conectadaNo compatible
Programación
Pages API de Metascheduled_publish_time, de 10 minutos a 30 días
Cuenta conectadaNo documentada; use su propia cola de tareas
Otras redes
Pages API de MetaSolo Páginas de Facebook
Cuenta conectadaLa misma API para LinkedIn, Instagram, WhatsApp y más

La misma conexión cubre las conversaciones: consulte la API de Facebook y Messenger de Unipile, cómo conectar una cuenta personal de Facebook y los precios de la API de Facebook Messenger.

Casos de uso

Casos de uso: publicaciones en CRM, herramientas sociales y agentes de IA

La API de publicaciones de Facebook rinde al máximo dentro de los productos en los que la gente ya trabaja, con cada usuario publicando desde sus propias cuentas.

Bandejas sociales y herramientas de comunidad

Los community managers publican y corrigen publicaciones de su perfil y sus Páginas, junto a sus mensajes.

Actividad en el CRM

Cuando el comercial lo solicita, una ficha de contacto muestra las últimas publicaciones de la persona, limitadas a lo que la cuenta conectada del comercial ya ve en Facebook.

Agentes de IA con aprobación

Un agente redacta una publicación, el usuario la aprueba y solo entonces su app envía el POST.

El mismo modelo de publicaciones funciona en otras redes: nuestra guía de la API de Instagram cubre la otra red de Meta.

Empiece a publicar en Facebook desde su app

Use la Pages API de Meta para sus propias Páginas. Cuando cada usuario publica, edita y lee publicaciones desde su propio perfil y sus Páginas, conecte sus cuentas a través de Unipile: una sola API REST.

Comisión Europea
Regulado por la UE Digital Markets Act (DMA)

Cada usuario conecta su propia cuenta, sin almacenamiento de perfiles. Unipile no es Meta Partner. Más información

Todos los endpoints de la API de Facebook en un solo lugar

Las publicaciones son solo una parte. Consulte todos los endpoints de Facebook disponibles con Unipile, de los mensajes a los perfiles, o lea la guía completa de la API de Facebook.

Preguntas frecuentes sobre la API de publicaciones de Facebook

Respuestas rápidas sobre Páginas, fotos, programación, ediciones, Grupos, vídeo y lectura de publicaciones.

Con la Pages API de Meta, envíe POST /{page_id}/feed con un message, usando un Page access token y los permisos pages_manage_posts, pages_read_engagement y pages_show_list. Con Unipile, el usuario conecta su cuenta de Facebook una sola vez y usted llama a POST /v2/{account_id}/posts con post_as igual al ID de una Página que gestiona y ha activado.

Con Unipile, varias imágenes en una publicación se muestran como un álbum, y una publicación puede llevar en su lugar un vídeo, nunca ambos. Con la Pages API de Meta, las fotos se publican mediante el edge /{page_id}/photos.

La Pages API de Meta sí: cree la publicación con published en false y un scheduled_publish_time entre 10 minutos y 30 días después, según la guía de la Pages API (la referencia de Page feed indica 75 días; pruébelo en su versión). Unipile no documenta una programación nativa, así que guarde la fecha prevista en su propia cola de tareas y llame a POST /v2/{account_id}/posts en el momento indicado.

Sí. Con la API de Meta, una app solo puede modificar las publicaciones de Página que creó, y elimina una publicación con DELETE /{page_post_id}. Con Unipile, PATCH /v2/{account_id}/posts/{post_id} modifica el texto y DELETE envía la publicación a la papelera, donde su autor puede leerla durante 30 días.

No. Meta declaró obsoletos la Groups API y el permiso publish_to_groups con la Graph API v19.0 en enero de 2024, y Unipile tampoco permite publicar en Grupos.

Puede publicar un vídeo. Con Unipile, una publicación admite un vídeo, que Facebook procesa de forma asíncrona. Los Reels no están documentados y las Stories no son compatibles.

Con la Graph API de Meta, llame a GET /{page_id}/feed con un Page access token y los permisos pages_read_engagement y pages_read_user_content; limit devuelve como máximo 100 publicaciones por petición. Con Unipile, llame a GET /v2/{account_id}/users/{user_id}/posts con el ID de una Página activada y siga next_cursor para obtener la página siguiente.

No. Unipile es una empresa independiente, no un Meta Partner, y no cuenta con el respaldo, el patrocinio ni la aprobación de Meta. Las publicaciones que publica su app proceden de las propias cuentas y Páginas de Facebook de sus usuarios. Facebook es una marca comercial de Meta Platforms, Inc.

No. Para publicar o leer publicaciones a través de Unipile, sus usuarios conectan su propia cuenta de Facebook, y las Páginas que gestionan, mediante la autenticación alojada. Se ahorra la app de Meta, los permisos de publicación y el App Review que exige la vía de la Pages API.

Unipile se ha diseñado en el espíritu de la Digital Markets Act (Ley de Mercados Digitales): cada usuario conecta su propia cuenta y decide lo que se publica, y Unipile actúa en su nombre sin almacenar perfiles de usuario. Más información en nuestra página sobre la Digital Markets Act.

Sí. Cada publicación que su app publica o lee pasa por una cuenta que sigue sujeta a las Condiciones de servicio de Meta. Limítese a usos legítimos, como publicar el propio contenido de sus usuarios y mostrar las publicaciones que su cuenta ya ve cuando lo solicitan; el spam y la automatización no autorizada pueden provocar la restricción de las cuentas.

¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.

Hable con un experto