REST API

Agendamento em Massa

Agendar varias publicacoes de uma vez

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

Parametro	Tipo	Descricao
`platforms`OBRIGATORIO	`PlatformType[]`	Plataformas alvo para todas as publicacoes
`timezone`OBRIGATORIO	`string`	Fuso horario IANA para agendamento
`posts`OBRIGATORIO	`PostItem[]`	Array de publicacoes a agendar (1-100)
`twitterConnectionIds`	`string[]`	Twitter account connection IDs
`linkedinConnectionIds`	`string[]`	LinkedIn account connection IDs
`instagramConnectionIds`	`string[]`	Instagram account connection IDs
`tiktokConnectionIds`	`string[]`	TikTok account connection IDs
`youtubeConnectionIds`	`string[]`	YouTube channel connection IDs
`pinterestConnectionIds`	`string[]`	Pinterest account connection IDs
`blueskyConnectionIds`	`string[]`	Bluesky account connection IDs
`threadsConnectionIds`	`string[]`	Threads account connection IDs
`pageIds`	`string[]`	Facebook/LinkedIn page IDs
`pinterestConfigs`	`PinterestConfig[]`	Configuracoes de Pinterest ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema
`tiktokConfigs`	`TikTokConfig[]`	Configuracoes de TikTok ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema
`instagramConfigs`	`InstagramConfig[]`	Configuracoes de Instagram ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema
`facebookConfigs`	`FacebookConfig[]`	Configuracoes de Facebook ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema
`youtubeConfigs`	`YouTubeConfig[]`	Configuracoes de YouTube ao nivel do lote aplicadas a todas as publicacoes. Consulte Configuracoes de Plataforma para o esquema

Campos do Item de Publicacao

Each post in the array can have its own content, media, and schedule time.

Post Item Parameters

Parametro	Tipo	Descricao
`contentType`OBRIGATORIO	`ContentType`	Tipo de conteudo (obrigatorio)
`text`	`string`	Conteudo de texto da publicacao
`platformTexts`	`PlatformText[]`	Per-platform text overrides
`mediaUrls`	`string[]`	URLs de ficheiros de media
`thumbnailUrl`	`string`	Thumbnail URL for video posts
`scheduledAt`OBRIGATORIO	`string`	Data de agendamento (obrigatorio, ISO 8601)
`pinterestConfigs`	`PinterestConfig[]`	Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao
`tiktokConfigs`	`TikTokConfig[]`	Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao
`instagramConfigs`	`InstagramConfig[]`	Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao
`facebookConfigs`	`FacebookConfig[]`	Substituicao por publicacao. Quando definida, tem prioridade sobre a configuracao ao nivel do lote para esta publicacao
`youtubeConfigs`	`YouTubeConfig[]`	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.

Rate limit

Maximum 100 posts per request. Each post is processed independently — if one fails validation, others will still be scheduled.

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
    }
  ]
}

Agendamento em Massa

Parametros do Corpo

Campos do Item de Publicacao

Post Item Parameters

AdaptlyPost

Contato