Prazos por API de plataforma: com quanta antecedência você pode agendar um post?

Com quanta antecedência você pode agendar um post na API de cada plataforma?

Pelas APIs oficiais, com quanta antecedência você pode agendar um post depende da rede: posts de Página do Facebook aceitam de 10 minutos a 30 dias, o Mastodon quer pelo menos 5 minutos sem teto documentado, e Instagram, LinkedIn, TikTok, Threads e Pinterest não aceitam horário futuro nenhum. Cada célula abaixo foi tirada da própria documentação da plataforma. Onde uma célula diz "nenhum documentado", a página da plataforma para aquele campo não cita limite.

Plataforma, endpoint e campo	Antecedência mínima	Antecedência máxima	Página de origem
Post de Página do Facebook, /{page-id}/feed, scheduled_publish_time	"between 10 minutes and 30 days"	30 dias	Pages API, guia de posts
Post de Página do Facebook, /{page-id}/feed, scheduled_publish_time	"between 10 minutes and 75 days"	75 dias	Graph API, referência Page Feed
Vídeo de Página do Facebook, /{page-id}/videos, scheduled_publish_time	"between 10 mins and 6 months"	6 meses	Graph API, referência Page Videos
Reel do 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, guia de publicação de Reels
YouTube, videos.insert ou videos.update, status.publishAt	Nenhum documentado	Nenhum documentado	YouTube Data API, recurso videos
Mastodon, POST /api/v1/statuses, scheduled_at	"at least 5 minutes in the future"	Nenhum documentado	Mastodon API, métodos de statuses
X Ads API, POST accounts/:account_id/scheduled_tweets, scheduled_at	Nenhum documentado	"up to one year in the future"	X Ads API, referência de Creatives
X API v2, POST /2/tweets	Sem campo de agendamento	Sem campo de agendamento	X API, Create Posts
Instagram, /<IG_ID>/media e /<IG_ID>/media_publish	Sem campo de agendamento	Sem campo de agendamento	Instagram Platform, Content Publishing
Threads, /{threads-user-id}/threads e /threads_publish	Sem campo de agendamento	Sem campo de agendamento	Threads API, referência de publicação
LinkedIn, POST /rest/posts	Sem campo de agendamento	Sem campo de agendamento	LinkedIn Marketing, Posts API
TikTok, /v2/post/publish/video/init/	Sem campo de agendamento	Sem campo de agendamento	TikTok Content Posting API, Direct Post
Pinterest, POST /v5/pins	Sem campo de agendamento	Sem campo de agendamento	Especificação OpenAPI da Pinterest API v5, PinCreate
Bluesky, registro app.bsky.feed.post	Sem campo de agendamento	Sem campo de agendamento	Lexicon app.bsky.feed.post

Duas regras saem da tabela. O mínimo é sempre uma verificação no servidor contra o relógio da plataforma, nunca contra o seu. O máximo, quando existe, vale para o momento da requisição à API, não para o momento em que você rascunhou o post.

Por que a Meta publica quatro máximos diferentes para o Facebook?

Porque quatro páginas da Meta dão um intervalo para o scheduled_publish_time e não há duas que concordem sobre o teto. O mínimo é consistente em 10 minutos. O máximo, não.

O guia da Pages API diz: "The publish date must be between 10 minutes and 30 days from the time of the API request." A referência Page Feed, para o mesmo parâmetro no mesmo endpoint /feed, diz: "UNIX timestamp indicating when post should go live. Must be date between 10 minutes and 75 days from the time of the API request." A referência Page Videos diz que o horário do post de vídeo "should be between 10 mins and 6 months from the time of publishing the video." O guia de publicação de Reels diz "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'."

Nada em nenhuma dessas páginas diz qual número vale, e nenhuma menciona as outras. Os números de 30 e 75 dias entram em conflito em um único endpoint, então uma ferramenta que permite 75 dias só funciona se a referência estiver certa. Se o guia estiver certo, toda requisição depois do dia 30 falha. Limitar posts de feed a 30 dias funciona qualquer que seja a página certa, e limitar Reels a 29 dias fica dentro do único número que a Meta dá para eles. O campo completo, seus formatos e seus erros estão em a janela do scheduled_publish_time do Facebook.

O guia de Reels acrescenta um segundo limite que importa para filas. Ele diz que a API de Reels "is limited to 30 API-published posts within a 24-hour moving period", e 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."

Quais plataformas não documentam antecedência máxima?

YouTube e Mastodon. Nenhuma das duas páginas informa um teto, então a resposta honesta para as duas é que a plataforma não publica um.

O recurso videos do YouTube descreve status.publishAt como "The date and time when the video is scheduled to publish", acrescenta que "It can be set only if the privacy status of the video is private" e não dá mínimo nem máximo. Ele descreve, sim, o que acontece na ponta mais próxima: "If your request schedules a video to be published at some time in the past, the video will be published right away." Então o YouTube não tem antecedência mínima no sentido de uma rejeição. Um horário no passado significa publicar agora. Cada campo publishAt do YouTube e como cada um falha cobre as regras de privacidade e de atualização em volta dele.

O Mastodon documenta o piso e para por aí. O parâmetro scheduled_at em POST /api/v1/statuses é um "Datetime at which to schedule a status" que "Must be at least 5 minutes in the future." A página não cita máximo. O código do servidor aplica esse piso com rigor e acrescenta tetos por conta que a documentação omite, tudo explicado em por que o scheduled_at da API do Mastodon precisa de 5 minutos de folga.

Quais plataformas não têm campo de agendamento nenhum?

Instagram, Threads, LinkedIn, TikTok, Pinterest, Bluesky e a X API v2. Nas sete, um post agendado é um post que uma ferramenta de agendamento guarda nos próprios servidores e publica pela chamada normal de criação quando chega a hora. A plataforma só vê uma publicação imediata.

A documentação deixa isso explícito de jeitos diferentes. A Posts API do LinkedIn diz sobre lifecycleState: "PUBLISHED is the only accepted field during creation." O guia de Content Publishing do Instagram parte do princípio de que o app faz a espera. Ele pede que os apps apliquem o limite de taxa de publicação por conta própria, "especially if your app allows app users to schedule posts to be published in the future." O schema PinCreate do Pinterest na especificação OpenAPI v5 lista ai_disclosures, alt_text, board_id, board_section_id, description, dominant_color, link, media_source, parent_pin_id, sponsor_id e title, sem campo de horário. O corpo de POST /2/tweets da X API v2 também não tem campo de horário. O registro de post do Bluesky tem um createdAt, mas o lexicon o chama de "Client-declared timestamp when this post was originally created", não de horário de publicação.

Sem fila na plataforma, os limites que importam são os tempos de vida dos objetos intermediários. Não dá para prepará-los com dias de antecedência:

Plataforma	Objeto	Regra de tempo documentada
Instagram	Contêiner de mídia	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	Contêiner de mídia	A Meta recomenda esperar "on average 30 seconds before publishing"

Então uma ferramenta que agenda um post do Instagram para o mês que vem guarda a mídia e a legenda ela mesma. Ela cria o contêiner perto do horário de publicação e publica dentro de 24 horas depois de criá-lo. Nessas sete redes, com quanta antecedência dá para planejar depende da ferramenta, não da API.

Agendar um post do Instagram para o mês que vem

1

Guardar. A ferramenta mantém a mídia e a legenda nos próprios servidores.

2

Esperar. O Instagram não vê nada, porque os endpoints dele não aceitam horário de publicação.

3

Criar o contêiner. Faça isso perto do horário de publicação, porque um contêiner não publicado expira em 24 horas.

4

Publicar. Use a chamada de criação normal em até 24 horas depois de criar o contêiner.

O que a X Ads API permite para Tweets agendados?

Até um ano de antecedência, com precisão de minuto, e só para anunciantes. O parâmetro scheduled_at em POST accounts/:account_id/scheduled_tweets é "The time, expressed in ISO 8601, that the Tweet should be published (or go live)", com duas observações: "Tweets can only be scheduled up to one year in the future" e "Tweets should only be scheduled at minute-granularity; seconds will be ignored."

Há uma pegadinha nos padrões. O parâmetro nullcast do mesmo endpoint tem true como padrão, o que a documentação define como criar "a nullcasted (or 'Promoted-only') Tweet." Um Tweet agendado criado com os padrões não aparece na timeline do perfil como post orgânico. O endpoint também exige as_user_id, e o anunciante "must grant your handle (or handles) access to their ads account via ads.x.com." É uma configuração diferente da postagem orgânica, que passa por POST /2/tweets e não tem campo de agendamento.

Que janela de antecedência um agendador deve aplicar?

Aplique o limite documentado mais rígido de cada plataforma, medido contra um relógio de servidor sincronizado, e rejeite tudo o que ficar fora dele antes de chamar a API. Rejeitar cedo dá à pessoa um erro legível em vez de um 100 ou 422 genérico.

Plataforma	Aplicar no mínimo	Aplicar no máximo
Posts de feed do Facebook	10 minutos, mais margem de relógio	30 dias
Reels do Facebook	10 minutos, mais margem de relógio	29 dias
Vídeos do Facebook	10 minutos, mais margem de relógio	6 meses
Mastodon	5 minutos, mais margem de relógio	Sem limite da plataforma
YouTube	Qualquer horário futuro; bloquear horários passados	Sem limite da plataforma
Tweets agendados do X Ads	Sem piso da plataforma	Um ano

A margem importa porque cada um desses mínimos é verificado no relógio da plataforma no momento em que a requisição chega. Um post enfileirado para daqui a 10 minutos e 5 segundos pode falhar se a requisição for lenta ou se o relógio local estiver atrasado. Nas redes sem campo de agendamento, a antecedência é a que a ferramenta suportar, e o único prazo da plataforma é o tempo de vida do objeto na tabela anterior.

Perguntas frequentes

Com quanta antecedência dá para agendar um post do Facebook pela API?

O guia da Pages API da Meta diz entre 10 minutos e 30 dias, enquanto a referência Page Feed diz entre 10 minutos e 75 dias para o mesmo campo de /feed. Vídeos de Página permitem até 6 meses e Reels até 29 dias. Limitar posts de feed a 30 dias fica dentro dos dois números do feed.

Dá para agendar posts do Instagram pela API do Instagram?

Não com um agendamento do lado da plataforma. Os endpoints de Content Publishing /<IG_ID>/media e /<IG_ID>/media_publish não aceitam horário de publicação, então uma ferramenta de agendamento guarda o post e o publica no momento escolhido. Os contêineres expiram se forem "not published within 24 hours".

Existe um tempo máximo de agendamento no YouTube?

O recurso videos do Google não documenta nenhum para status.publishAt. Ele diz apenas que o campo "can be set only if the privacy status of the video is private" e que um horário no passado publica o vídeo "right away".

Qual é a menor antecedência que alguma API de plataforma aceita?

O piso documentado do Mastodon é "at least 5 minutes in the future". O do Facebook é de 10 minutos em todas as páginas da Meta que dão um intervalo para o scheduled_publish_time. A referência Page Photos não dá intervalo nenhum. O YouTube não documenta piso e publica horários passados na hora.

A API do LinkedIn suporta posts agendados?

Não. A Posts API diz sobre lifecycleState que "PUBLISHED is the only accepted field during creation", e a requisição de criação não tem campo de horário. Ferramentas que agendam posts do LinkedIn os guardam e chamam POST /rest/posts no horário escolhido.

Com quanta antecedência dá para agendar um Tweet pela API?

Só a X Ads API tem campo de agendamento. O endpoint scheduled_tweets dela permite horários "up to one year in the future", ignora os segundos e tem nullcast como true por padrão, o que torna o Tweet só promovido. O endpoint POST /2/tweets da X API v2 não tem campo de agendamento.

Com quanta antecedência dá para agendar um Reel do Facebook pela API?

O guia de publicação de Reels diz que o horário de publicação deve ser maior que 10 minutos a partir do horário atual e ficar dentro de 29 dias da data atual, com video_state definido como "SCHEDULED". Os Reels também têm um limite de 30 posts publicados por API em um período móvel de 24 horas. A Meta recomenda que o seu app aplique esse limite quando permitir agendamento.

A API do Mastodon tem um tempo máximo de agendamento?

A documentação não cita nenhum. Ela só exige que scheduled_at esteja pelo menos 5 minutos no futuro. O código-fonte do servidor acrescenta limites por conta que a documentação omite, então um agendador não deve presumir uma fila sem limite.

Dá para agendar posts do Threads ou do TikTok pelas APIs deles?

Nenhuma das duas tem campo de agendamento, então a ferramenta guarda o post e o publica no horário escolhido. Os prazos valem só para objetos intermediários. A upload_url do TikTok em /v2/post/publish/video/init/ é válida por uma hora após a emissão, e a Meta recomenda esperar em média 30 segundos antes de publicar um contêiner do Threads.

Por que um post do Facebook agendado para exatamente 10 minutos pode falhar?

Cada mínimo é checado no relógio da plataforma quando a requisição chega. Um post com 10 minutos e 5 segundos de antecedência pode falhar se a requisição demorar ou o relógio local estiver atrasado. Some uma margem de relógio ao mínimo de 10 minutos e rejeite o que ficar fora da janela antes de chamar a API.