Plazos por API de cada plataforma: ¿con cuánta antelación puedes programar un post?

¿Con cuánta antelación puedes programar un post en la API de cada plataforma?

A través de las APIs oficiales, con cuánta antelación puedes programar un post depende de la red: los posts de Página de Facebook admiten de 10 minutos a 30 días, Mastodon quiere al menos 5 minutos sin techo documentado, e Instagram, LinkedIn, TikTok, Threads y Pinterest no aceptan ninguna hora futura. Cada celda de la tabla sale de la propia documentación de la plataforma. Donde una celda dice "Ninguna documentada", la página de la plataforma para ese campo no nombra ningún límite.

Plataforma, endpoint y campo	Antelación mínima	Antelación máxima	Página de origen
Post de Página de Facebook, /{page-id}/feed, scheduled_publish_time	"between 10 minutes and 30 days"	30 días	Pages API, guía de Posts
Post de Página de Facebook, /{page-id}/feed, scheduled_publish_time	"between 10 minutes and 75 days"	75 días	Graph API, referencia de Page Feed
Vídeo de Página de Facebook, /{page-id}/videos, scheduled_publish_time	"between 10 mins and 6 months"	6 meses	Graph API, referencia de Page Videos
Reel de Facebook, /{page-id}/video_reels, scheduled_publish_time	"greater than 10 minutes from the current time"	"within 29 days of the current date"	Video API, guía Reels Publishing
YouTube, videos.insert o videos.update, status.publishAt	Ninguna documentada	Ninguna documentada	YouTube Data API, recurso videos
Mastodon, POST /api/v1/statuses, scheduled_at	"at least 5 minutes in the future"	Ninguna documentada	Mastodon API, métodos de statuses
X Ads API, POST accounts/:account_id/scheduled_tweets, scheduled_at	Ninguna documentada	"up to one year in the future"	X Ads API, referencia de Creatives
X API v2, POST /2/tweets	Sin campo de programación	Sin campo de programación	X API, Create Posts
Instagram, /<IG_ID>/media y /<IG_ID>/media_publish	Sin campo de programación	Sin campo de programación	Instagram Platform, Content Publishing
Threads, /{threads-user-id}/threads y /threads_publish	Sin campo de programación	Sin campo de programación	Threads API, referencia de Publishing
LinkedIn, POST /rest/posts	Sin campo de programación	Sin campo de programación	LinkedIn Marketing, Posts API
TikTok, /v2/post/publish/video/init/	Sin campo de programación	Sin campo de programación	TikTok Content Posting API, Direct Post
Pinterest, POST /v5/pins	Sin campo de programación	Sin campo de programación	Especificación OpenAPI de Pinterest API v5, PinCreate
Bluesky, registro app.bsky.feed.post	Sin campo de programación	Sin campo de programación	Lexicon app.bsky.feed.post

De la tabla salen dos reglas. El mínimo es siempre una comprobación del lado del servidor contra el reloj de la plataforma, nunca contra el tuyo. El máximo, donde existe, se aplica al momento de la petición a la API, no al momento en que redactaste el post.

¿Por qué publica Meta cuatro máximos distintos para Facebook?

Porque cuatro páginas de Meta dan un rango para scheduled_publish_time y no hay dos que coincidan en el techo. El mínimo es constante, 10 minutos. El máximo no.

La guía de la Pages API dice: "The publish date must be between 10 minutes and 30 days from the time of the API request." La referencia de Page Feed, para el mismo parámetro en el mismo endpoint /feed, dice: "UNIX timestamp indicating when post should go live. Must be date between 10 minutes and 75 days from the time of the API request." La referencia de Page Videos dice que la hora de publicación del vídeo "should be between 10 mins and 6 months from the time of publishing the video." La guía Reels Publishing dice "the publish time must be greater than 10 minutes from the current time and within 29 days of the current date, and video_state must be set to 'SCHEDULED'."

Ninguna de esas páginas dice qué cifra manda, y ninguna menciona las otras. Las cifras de 30 y 75 días chocan en un mismo endpoint, así que una herramienta que permita 75 días solo funciona si la referencia tiene razón. Si la tiene la guía, toda petición más allá del día 30 falla. Limitar los posts del feed a 30 días funciona sea cual sea la página correcta, y limitar los Reels a 29 días se mantiene dentro de la única cifra que Meta da para ellos. El campo completo, sus formatos y sus errores se cubren en el plazo de scheduled_publish_time de Facebook.

La guía de Reels añade un segundo límite que importa para las colas. Dice que la API de Reels "is limited to 30 API-published posts within a 24-hour moving period", y que "Meta recommends that your app also enforces the publishing rate limit, especially if your app allows app users to schedule posts to be published in the future."

¿Qué plataformas no documentan una antelación máxima?

YouTube y Mastodon. Ninguna de las dos páginas indica un techo, así que la respuesta honesta para ambas es que la plataforma no lo publica.

El recurso videos de YouTube describe status.publishAt como "The date and time when the video is scheduled to publish", añade que "It can be set only if the privacy status of the video is private", y no da mínimo ni máximo. Sí describe lo que pasa en el extremo cercano: "If your request schedules a video to be published at some time in the past, the video will be published right away." Así que YouTube no tiene antelación mínima en el sentido de un rechazo. Una hora en el pasado significa publicar ya. Cada campo publishAt de YouTube y cómo falla cada uno cubre las reglas de privacidad y de actualización que lo rodean.

Mastodon documenta el suelo y ahí se queda. El parámetro scheduled_at de POST /api/v1/statuses es un "Datetime at which to schedule a status" que "Must be at least 5 minutes in the future." La página no nombra ningún máximo. El código del servidor aplica ese suelo de forma estricta y añade topes por cuenta que la documentación omite, todo recogido en por qué el scheduled_at de la API de Mastodon necesita 5 minutos de margen.

¿Qué plataformas no tienen ningún campo de programación?

Instagram, Threads, LinkedIn, TikTok, Pinterest, Bluesky y la X API v2. En las siete, un post programado es uno que una herramienta de programación guarda en sus propios servidores y publica mediante la llamada de creación normal cuando llega la hora. La plataforma solo ve una publicación inmediata.

La documentación lo deja claro de distintas formas. La Posts API de LinkedIn dice de lifecycleState: "PUBLISHED is the only accepted field during creation." La guía Content Publishing de Instagram da por hecho que la app es la que espera. Pide a las apps que apliquen ellas mismas el límite de publicación, "especially if your app allows app users to schedule posts to be published in the future." El esquema PinCreate de Pinterest en la especificación OpenAPI v5 lista ai_disclosures, alt_text, board_id, board_section_id, description, dominant_color, link, media_source, parent_pin_id, sponsor_id y title, sin ningún campo de hora. El cuerpo de POST /2/tweets de la X API v2 tampoco tiene campo de hora. El registro de post de Bluesky tiene un createdAt, pero el lexicon lo llama "Client-declared timestamp when this post was originally created", no una hora de publicación.

Sin cola en la plataforma, los límites que importan son las vidas útiles de los objetos intermedios. No puedes prepararlos con días de antelación:

Plataforma	Objeto	Regla de tiempo documentada
Instagram	Contenedor de medios	EXPIRED: "The container was not published within 24 hours and has expired."
TikTok	upload_url de /v2/post/publish/video/init/	"valid for one hour after issuance"
Threads	Contenedor de medios	Meta recomienda esperar "on average 30 seconds before publishing"

Así que una herramienta que programa un post de Instagram para el mes que viene guarda ella misma los medios y el texto. Crea el contenedor cerca de la hora de publicación y publica dentro de las 24 horas siguientes a crearlo. En estas siete redes, hasta dónde puedes planificar depende de la herramienta, no de la API.

Programar un post de Instagram para el mes que viene

1

Guardar. La herramienta conserva el contenido multimedia y el texto en sus propios servidores.

2

Esperar. Instagram no ve nada, porque sus endpoints no aceptan una hora de publicación.

3

Crear el contenedor. Hazlo cerca de la hora de publicación, porque un contenedor sin publicar caduca a las 24 horas.

4

Publicar. Usa la llamada de creación normal dentro de las 24 horas posteriores a crear el contenedor.

¿Qué permite la X Ads API para los Tweets programados?

Hasta un año por delante, con precisión de minutos, y solo para anunciantes. El parámetro scheduled_at de POST accounts/:account_id/scheduled_tweets es "The time, expressed in ISO 8601, that the Tweet should be published (or go live)", con dos notas: "Tweets can only be scheduled up to one year in the future" y "Tweets should only be scheduled at minute-granularity; seconds will be ignored."

Hay una trampa en los valores por defecto. El parámetro nullcast del mismo endpoint vale true por defecto, que la documentación define como crear "a nullcasted (or 'Promoted-only') Tweet." Un Tweet programado creado con los valores por defecto no aparece en la línea de tiempo del perfil como post orgánico. El endpoint también exige as_user_id, y el anunciante "must grant your handle (or handles) access to their ads account via ads.x.com." Es una configuración distinta de la publicación orgánica, que pasa por POST /2/tweets y no tiene campo de programación.

¿Qué ventana de antelación debería aplicar un programador?

Aplica el límite documentado más estricto de cada plataforma, medido contra un reloj de servidor sincronizado, y rechaza lo que quede fuera antes de llamar a la API. Rechazar pronto le da a la persona un error legible en lugar de un 100 o un 422 genéricos.

Plataforma	Aplicar como mínimo	Aplicar como máximo
Posts del feed de Facebook	10 minutos, más margen de reloj	30 días
Reels de Facebook	10 minutos, más margen de reloj	29 días
Vídeos de Facebook	10 minutos, más margen de reloj	6 meses
Mastodon	5 minutos, más margen de reloj	Sin límite de la plataforma
YouTube	Cualquier hora futura; bloquear horas pasadas	Sin límite de la plataforma
Tweets programados de X Ads	Sin suelo de la plataforma	Un año

El margen importa porque cada uno de estos mínimos se comprueba con el reloj de la plataforma en el momento en que llega la petición. Un post en cola para dentro de 10 minutos y 5 segundos puede fallar si la petición es lenta o el reloj local va atrasado. En las redes sin campo de programación, la antelación es la que admita la herramienta, y el único plazo de la plataforma es la vida útil de los objetos de la tabla anterior.

Preguntas frecuentes

¿Con cuánta antelación puedes programar un post de Facebook a través de la API?

La guía de la Pages API de Meta dice entre 10 minutos y 30 días, mientras que la referencia de Page Feed dice entre 10 minutos y 75 días para el mismo campo de /feed. Los vídeos de Página permiten hasta 6 meses y los Reels hasta 29 días. Limitar los posts del feed a 30 días se mantiene dentro de las dos cifras del feed.

¿Se pueden programar posts de Instagram con la API de Instagram?

No con una programación del lado de la plataforma. Los endpoints de Content Publishing /<IG_ID>/media y /<IG_ID>/media_publish no admiten hora de publicación, así que una herramienta de programación guarda el post y lo publica en el momento elegido. Los contenedores caducan si están "not published within 24 hours".

¿Hay un tiempo máximo de programación en YouTube?

El recurso videos de Google no documenta ninguno para status.publishAt. Solo dice que el campo "can be set only if the privacy status of the video is private" y que una hora en el pasado publica el vídeo "right away".

¿Cuál es la antelación más corta que acepta una API de plataforma?

El suelo documentado de Mastodon es "at least 5 minutes in the future". El de Facebook es de 10 minutos en todas las páginas de Meta que dan un rango para scheduled_publish_time. La referencia de Page Photos no da ningún rango. YouTube no documenta ningún suelo y publica de inmediato las horas pasadas.

¿La API de LinkedIn admite posts programados?

No. La Posts API dice de lifecycleState que "PUBLISHED is the only accepted field during creation", y la petición de creación no tiene campo de hora. Las herramientas que programan posts de LinkedIn los guardan y llaman a POST /rest/posts a la hora elegida.

¿Con cuánta antelación puedes programar un Tweet a través de la API?

Solo la X Ads API tiene un campo de programación. Su endpoint scheduled_tweets permite horas "up to one year in the future", ignora los segundos y pone nullcast en true por defecto, lo que hace que el Tweet sea solo promocionado. El endpoint POST /2/tweets de la X API v2 no tiene campo de programación.

¿Con cuánta antelación puedes programar un Reel de Facebook a través de la API?

La guía de publicación de Reels dice que la hora de publicación debe ser posterior a 10 minutos desde la hora actual y estar dentro de los 29 días de la fecha actual, con video_state en "SCHEDULED". Los Reels también tienen un límite de 30 publicaciones por API en un periodo móvil de 24 horas. Meta recomienda que tu app aplique ese límite cuando permita programar.

¿Tiene la API de Mastodon un tiempo máximo de programación?

La documentación no indica ninguno. Solo exige que scheduled_at esté al menos 5 minutos en el futuro. El código fuente del servidor añade límites por cuenta que la documentación omite, así que un programador no debería dar por hecho que puede encolar sin tope.

¿Se pueden programar posts de Threads o TikTok con sus APIs?

Ninguna tiene un campo de programación, así que la herramienta guarda el post y lo publica a la hora elegida. Los plazos solo afectan a los objetos intermedios. La upload_url de TikTok de /v2/post/publish/video/init/ es válida durante una hora tras emitirse, y Meta recomienda esperar de media 30 segundos antes de publicar un contenedor de Threads.

¿Por qué puede fallar en Facebook un post programado justo a 10 minutos?

Cada mínimo se comprueba con el reloj de la plataforma cuando llega la petición. Un post con 10 minutos y 5 segundos de antelación puede fallar si la petición tarda o el reloj local va atrasado. Añade un margen de reloj al mínimo de 10 minutos y rechaza lo que quede fuera de la ventana antes de llamar a la API.