REST APIPOST

Agendamento em Massa

Agende varias publicacoes de uma vez com configuracoes especificas por plataforma

POSThttps://post.adaptlypost.com/post/api/v1/social-posts/bulk

Agende ate 100 publicacoes de uma vez. Cada publicacao pode ter o seu proprio conteudo, media e hora agendada, partilhando as mesmas ligacoes de plataforma.

Chave API (Bearer token)

Parametros do Corpo

ParametroTipoDescricao
platformsOBRIGATORIOPlatformType[]Plataformas alvo para todas as publicacoes
timezoneOBRIGATORIOstringFuso horario IANA para agendamento
postsOBRIGATORIOPostItem[]Array de publicacoes a agendar (1-100)
twitterConnectionIdsstring[]IDs de conexão da conta do Twitter
linkedinConnectionIdsstring[]IDs de conexão da conta do LinkedIn
instagramConnectionIdsstring[]IDs de conexão da conta do Instagram
tiktokConnectionIdsstring[]IDs de conexão da conta do TikTok
youtubeConnectionIdsstring[]IDs de conexão do canal do YouTube
pinterestConnectionIdsstring[]IDs de conexão da conta do Pinterest
blueskyConnectionIdsstring[]IDs de conexão da conta do Bluesky
threadsConnectionIdsstring[]IDs de conexão da conta do Threads
pageIdsstring[]IDs de páginas do Facebook/LinkedIn
pinterestConfigsPinterestConfig[]Configuracoes de Pinterest ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema
tiktokConfigsTikTokConfig[]Configuracoes de TikTok ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema
instagramConfigsInstagramConfig[]Configuracoes de Instagram ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema
facebookConfigsFacebookConfig[]Configuracoes de Facebook ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema
youtubeConfigsYouTubeConfig[]Configuracoes de YouTube ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema

Campos do Item de Publicacao

Cada publicação no array pode ter seu próprio conteúdo, mídia e horário de agendamento.

Parâmetros do item de publicação

ParametroTipoDescricao
contentTypeOBRIGATORIOContentTypeTipo de conteudo (obrigatorio)
textstringConteudo de texto da publicacao
platformTextsPlatformText[]Substituições de texto por plataforma
mediaUrlsstring[]URLs de ficheiros de media
thumbnailUrlstringURL da miniatura para publicações em vídeo
scheduledAtOBRIGATORIOstringData de agendamento (obrigatorio, ISO 8601)
pinterestConfigsPinterestConfig[]Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao
tiktokConfigsTikTokConfig[]Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao
instagramConfigsInstagramConfig[]Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao
facebookConfigsFacebookConfig[]Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao
youtubeConfigsYouTubeConfig[]Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao

Substituicoes de configuracao de plataforma por publicacao

As configuracoes de plataforma podem ser definidas em dois niveis: nivel do lote (aplicadas a todas as publicacoes como predefinicao) e por publicacao (substituem o nivel do lote para essa publicacao especifica). Se uma publicacao incluir a sua propria configuracao de plataforma, substitui completamente a configuracao ao nivel do lote para essa plataforma.

Limite de taxa

Máximo de 100 publicações por solicitação. Cada publicação é processada de forma independente. Se uma falhar na validação, as outras ainda serão agendadas.

Uma conta por plataforma

Apenas uma conta por plataforma e permitida. Todas as publicacoes do lote partilham as mesmas conexoes, portanto nao pode incluir multiplos IDs de conexao para a mesma plataforma. Esta restricao e aplicada para cumprir os Termos de Servico das plataformas.
Agendar publicacoes em massa
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/social-posts/bulk \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "platforms": ["YOUTUBE", "PINTEREST"],
    "timezone": "America/New_York",
    "youtubeConnectionIds": ["conn_yt123"],
    "pinterestConnectionIds": ["conn_pin456"],
    "youtubeConfigs": [{
      "connectionId": "conn_yt123",
      "postType": "SHORTS",
      "privacyStatus": "public"
    }],
    "pinterestConfigs": [{
      "connectionId": "conn_pin456",
      "boardId": "board_abc",
      "title": "Default pin title"
    }],
    "posts": [
      {
        "contentType": "VIDEO",
        "text": "First video!",
        "mediaUrls": ["https://cdn.adaptlypost.com/uploads/video1.mp4"],
        "scheduledAt": "2026-03-15T10:00:00Z"
      },
      {
        "contentType": "VIDEO",
        "text": "Second video with custom config",
        "mediaUrls": ["https://cdn.adaptlypost.com/uploads/video2.mp4"],
        "scheduledAt": "2026-03-15T14:00:00Z",
        "youtubeConfigs": [{
          "connectionId": "conn_yt123",
          "postType": "VIDEO",
          "videoTitle": "Full tutorial",
          "privacyStatus": "unlisted"
        }]
      }
    ]
  }'
200
{
  "totalScheduled": 2,
  "totalFailed": 0,
  "results": [
    {
      "postId": "post_abc001",
      "success": true,
      "isScheduled": true,
      "scheduledAt": "2026-03-15T10:00:00Z",
      "errorMessage": null
    },
    {
      "postId": "post_abc002",
      "success": true,
      "isScheduled": true,
      "scheduledAt": "2026-03-15T14:00:00Z",
      "errorMessage": null
    }
  ]
}