SocialSchedule
Comece grátis

API do SocialSchedule — Agendamento Programático de Mídias Sociais

A API do SocialSchedule é uma API de agendamento de mídia social para publicação em múltiplas plataformas: autenticar espaços de trabalho, fazer upload de mídia, criar postagens agendadas, gerenciar filas, receber webhooks e puxar análises—sem esperar por um complemento empresarial.

Comece grátis

Exemplos de código

Os exemplos permanecem em inglês — copie para o seu terminal, cliente MCP ou arquivo de habilidade.

Cabeçalhos de autenticação
Authorization: Bearer ssk_live_xxx
X-Workspace-Id: ws_abc123
Criar postagem
curl -X POST https://api.socialschedule.ai/v1/posts \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram", "tiktok"],
    "caption": "New drop is live",
    "mediaIds": ["media_01"],
    "scheduledFor": "2026-04-02T18:00:00Z",
    "utm": {
      "source": "instagram",
      "medium": "social",
      "campaign": "spring-drop"
    }
  }'
Fazer upload de mídia
curl -X POST https://api.socialschedule.ai/v1/media \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -F "file=@./product.mp4"
Criar webhook
curl -X POST https://api.socialschedule.ai/v1/webhooks \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/socialschedule",
    "events": ["post.published", "post.failed"]
  }'
CLIMCPSkills

Autenticação e áreas de trabalho

Use tokens de portador específicos para uma área de trabalho. Passe identificadores de área de trabalho para aplicativos de agência multi-inquilino. Para desenvolvedores e agentes de IA, “Autenticação e áreas de trabalho” não é uma seção cheia de jargões—é um sistema operacional: planeje pilares, elabore com IA, agende em janelas ótimas e meça resultados que importam.

Gire chaves e prefira o menor privilégio. SocialSchedule conecta esse fluxo de trabalho entre Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, e Google Business Profile de um calendário e fila nativos de IA—não uma caixa de legenda adicionada em um publicador estilo 2012. Mantenha a formatação, aprovações e análises nativas da plataforma no mesmo ciclo.

Espelhe o mesmo modelo de permissão que o aplicativo web. Os exemplos de Curl abaixo permanecem em inglês/técnico por design. Quando estiver pronto, abra https://app.socialschedule.ai/login para agendar ao vivo—ou automatize os mesmos passos com CLI, MCP, API e Skills enquanto humanos mantêm as diretrizes de voz da marca.

Criar, atualizar e cancelar postagens agendadas

Os endpoints CRUD cobrem todo o ciclo de vida de uma postagem agendada. As chaves de idempotência ajudam em tentativas seguras. Para desenvolvedores e agentes de IA, “Criar, atualizar e cancelar postagens agendadas” não é uma seção de palavras da moda—é um sistema operacional: pilares de planejamento, elaboração com IA, agendamento em janelas ideais e medição de resultados que realmente importam.

Cancele ou reagende quando as campanhas atrasarem. O SocialSchedule conecta esse fluxo de trabalho através do Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile de um calendário e fila nativos de IA—não uma caixa de legenda adaptada em um editor no estilo de 2012. Mantenha a formatação, aprovações e análises nativas da plataforma no mesmo ciclo.

Suporte para rascunhos versus estados agendados explicitamente. Quando você estiver pronto, abra https://app.socialschedule.ai/login para agendar ao vivo—ou automatize os mesmos passos com CLI, MCP, API e Skills enquanto humanos mantêm os limites da voz da marca.

Padrões de API conceituais

Autentique-se com um token bearer com escopo de workspace. Crie postagens com alvos de plataforma, variantes de legenda, IDs de mídia e timestamps de agendamento. Use chaves de idempotência em tentativas.

Forma de exemplo (ilustrativa): `POST /v1/posts` com `{ "platforms": ["instagram","x"], "body": "...", "mediaIds": [...], "scheduledAt": "..." }`. Inscreva-se nos webhooks `post.published` / `post.failed` para alertas de operações.

Prefira rascunho → aprovar → agendar para segurança da marca. Limite de taxa com retrocesso em erros 429. Detalhes completos do OpenAPI são enviados com seu workspace de desenvolvedor.

Carregamento de mídia e cargas específicas da plataforma

Faça upload de mídia, depois referência os IDs da mídia nas chamadas de criação de postagens. Anexe campos específicos da plataforma onde as redes exigem. Para desenvolvedores e agentes de IA, "Carregamento de mídia e cargas específicas da plataforma" não é uma seção de palavras da moda—é um sistema operacional: planeje pilares, faça um esboço com IA, agende em janelas ótimas e meça resultados que importam.

Valide as proporções antes do dia do lançamento. O SocialSchedule conecta esse fluxo de trabalho em Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile a partir de um calendário e fila nativos de IA—não uma caixa de legenda adaptada de um publicador de estilo 2012. Mantenha a formatação, aprovações e análises nativas da plataforma no mesmo ciclo.

Reutilize mídia entre variantes de plataforma quando apropriado. Quando estiver pronto, abra https://app.socialschedule.ai/login para agendar ao vivo—ou automatize os mesmos passos com CLI, MCP, API e Skills enquanto humanos mantêm as diretrizes de voz da marca.

Calendários, filas e auxiliares de horários ideais

Liste janelas de calendário e enfileire posts para horários de publicação ideais. Construa ferramentas internas que mostrem a mesma semana que os profissionais de marketing veem. Para desenvolvedores e agentes de IA, “Calendários, filas e auxiliares de horários ideais” não é uma seção de jargão - é um sistema operacional: planeje pilares, rascunhe com IA, agende em janelas ideais e meça resultados que importam.

Preencha lacunas programaticamente após revisões analíticas. O SocialSchedule conecta esse fluxo de trabalho em Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile a partir de um calendário e fila nativos de IA - não uma caixa de legenda suplementada em um publicador no estilo de 2012. Mantenha a formatação, aprovações e análises nativas da plataforma no mesmo loop.

Combine com Skills para um planejamento de nível superior. Quando estiver pronto, abra https://app.socialschedule.ai/login para agendar ao vivo - ou automatize os mesmos passos com CLI, MCP, API e Skills enquanto humanos mantêm as diretrizes de voz da marca.

Endpoints de análise que importam

Busque métricas de engajamento e entrega para conteúdo agendado. Potencialize portais de clientes e painéis internos. Para desenvolvedores e agentes de IA, “Endpoints de análise que importam” não é uma seção de jargões—é um sistema operacional: planeje pilares, rabisque com IA, agende em janelas ótimas e meça resultados que importam.

Evite relatórios apenas de vaidade em emails automáticos. O SocialSchedule conecta esse fluxo de trabalho em Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile a partir de um calendário e fila nativos de IA—não uma caixa de legendas adaptada de um publicador do estilo de 2012. Mantenha a formatação, aprovações e análises nativas da plataforma na mesma corrente.

Feche o ciclo para os trabalhos de geração da próxima semana. Quando estiver pronto, abra https://app.socialschedule.ai/login para agendar ao vivo—ou automatize os mesmos passos com CLI, MCP, API e Skills enquanto humanos mantêm as diretrizes de voz da marca.

Webhooks para eventos publicados / falhados

Inscreva-se nos eventos post.published e post.failed. Gere alertas no Slack ou tickets quando publicações falharem. Para desenvolvedores e agentes de IA, “Webhooks para eventos publicados / falhados” não é uma seção de moda—é um sistema operacional: planeje pilares, elabore com IA, agende em janelas ótimas e meça resultados que importam.

Verifique assinaturas antes de confiar em cargas. O SocialSchedule conecta esse fluxo de trabalho pelo Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile a partir de um calendário e fila nativos de IA—não uma caixa de legenda adaptada em um publicador no estilo de 2012. Mantenha a formatação, aprovações e análises nativas da plataforma no mesmo ciclo.

Mantenha os manipuladores de webhook idempotentes. Quando estiver pronto, abra https://app.socialschedule.ai/login para agendar ao vivo—ou automatize os mesmos passos com CLI, MCP, API e Skills enquanto os humanos mantêm as diretrizes de voz da marca.

Limites de taxa, idempotência e melhores práticas

Respeite os limites de taxa; faça uma pausa; tente novamente com chaves de idempotência. Registre IDs de correlação para suporte. Para desenvolvedores e agentes de IA, "Limites de taxa, idempotência e melhores práticas" não é uma seção de palavras da moda—é um sistema operacional: planeje pilares, redija com IA, agende em janelas ótimas e meça os resultados que importam.

Prefira rascunho→aprovação→agendamento para segurança da marca. O SocialSchedule conecta esse fluxo de trabalho em Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile a partir de um calendário e fila nativos de IA—não uma caixa de legenda anexada em um editor no estilo de 2012. Mantenha a formatação, aprovações e análises nativas da plataforma no mesmo ciclo.

Documente seus runbooks de automação interna. Quando estiver pronto, abra https://app.socialschedule.ai/login para agendar ao vivo—ou automatize os mesmos passos com CLI, MCP, API e Skills enquanto humanos mantêm as diretrizes de voz da marca.

Inícios rápidos da API para plataformas comuns

Caminhos comuns incluem agendamento de postagens no Instagram via API, atualizações de empresa no LinkedIn e lançamentos em várias plataformas. Comece com um teste de integração de uma plataforma, depois expanda. Para desenvolvedores e agentes de IA, "inícios rápidos da API para plataformas comuns" não é uma seção de palavras da moda - é um sistema operacional: planeje pilares, crie com IA, agende em janelas otimizadas e meça os resultados que importam.

As agências podem criar portais para clientes na API. O SocialSchedule conecta esse fluxo de trabalho através do Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky e Google Business Profile a partir de um calendário e fila nativos de IA - não uma caixa de legenda acoplada em um publicador no estilo de 2012. Mantenha a formatação nativa da plataforma, aprovações e análises no mesmo ciclo.

O MCP pode ser mais rápido para interfaces de agentes; a API vence para o seu backend. Crie uma chave de API no aplicativo e envie sua primeira postagem agendada. Quando estiver pronto, abra https://app.socialschedule.ai/login para agendar ao vivo - ou automatize os mesmos passos com CLI, MCP, API e Skills enquanto os humanos mantêm os limites da voz da marca.

Perguntas frequentes

O SocialSchedule oferece uma API pública?+

Sim. A API do SocialSchedule suporta agendamento programático, mídias, filas, webhooks e análises.

Posso agendar posts no Instagram via API?+

Sim, para contas do Instagram conectadas ao seu espaço de trabalho (sujeito às políticas e permissões da plataforma).

Quais plataformas são suportadas na API?+

Plataformas disponíveis no SocialSchedule—Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, Google Business Profile—quando conectadas.

Como funciona a autenticação?+

Use uma chave API bearer escopo para um espaço de trabalho. Mantenha chaves em um gerenciador de segredos.

Existem webhooks para eventos de publicação?+

Sim. Inscreva-se para eventos publicados e falhados para alertas operacionais.

Posso buscar análises através da API?+

Sim. Extraia métricas para alimentar dashboards e loops de automação.

Quais são os limites de taxa?+

Limites de taxa se aplicam por espaço de trabalho/token. Espere em 429s e use chaves de idempotência para tentativas seguras.

Existe um SDK oficial?+

Comece com a API REST e exemplos de curl; SDKs/clientes da comunidade podem ser adicionados à medida que a superfície se estabiliza.

Como a API se compara ao servidor MCP?+

A API é ideal para seus servidores e produtos; o MCP é ideal para agentes de IA que chamam ferramentas interativamente.

As agências podem construir portais de cliente na API?+

Sim. Muitas agências envolvem a API para calendários voltados para o cliente e aprovações.

Como faço para enviar mídias?+

Use o endpoint de upload de mídia e, em seguida, referencie os IDs de mídia retornados ao criar posts.

Onde estão os docs de referência / OpenAPI?+

Use este guia para startups rápidas; detalhes completos do OpenAPI acompanham a documentação do seu espaço de trabalho de desenvolvedor.

Páginas relacionadas

Crie uma chave de API e agende programaticamente

Publicação multiplataforma com webhooks, filas e análises.

Comece grátis