REST APIPOST

Programacion masiva

Programe multiples publicaciones a la vez con configuraciones especificas por plataforma

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

Programe hasta 100 publicaciones a la vez. Cada publicacion puede tener su propio contenido, medios y hora programada mientras comparte las mismas conexiones de plataforma.

Clave API (token Bearer)

Parametros del cuerpo

ParametroTipoDescripcion
platformsOBLIGATORIOPlatformType[]Plataformas objetivo para todas las publicaciones
timezoneOBLIGATORIOstringZona horaria IANA para programacion
postsOBLIGATORIOPostItem[]Array de publicaciones a programar (1-100)
twitterConnectionIdsstring[]IDs de conexión de la cuenta de Twitter
linkedinConnectionIdsstring[]IDs de conexión de la cuenta de LinkedIn
instagramConnectionIdsstring[]IDs de conexión de la cuenta de Instagram
tiktokConnectionIdsstring[]IDs de conexión de la cuenta de TikTok
youtubeConnectionIdsstring[]IDs de conexión del canal de YouTube
pinterestConnectionIdsstring[]IDs de conexión de la cuenta de Pinterest
blueskyConnectionIdsstring[]IDs de conexión de la cuenta de Bluesky
threadsConnectionIdsstring[]IDs de conexión de la cuenta de Threads
pageIdsstring[]IDs de páginas de Facebook/LinkedIn
pinterestConfigsPinterestConfig[]Configuraciones de Pinterest a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema
tiktokConfigsTikTokConfig[]Configuraciones de TikTok a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema
instagramConfigsInstagramConfig[]Configuraciones de Instagram a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema
facebookConfigsFacebookConfig[]Configuraciones de Facebook a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema
youtubeConfigsYouTubeConfig[]Configuraciones de YouTube a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema

Campos del elemento de publicacion

Cada publicación del arreglo puede tener su propio contenido, medios y hora de programación.

Parámetros del elemento de publicación

ParametroTipoDescripcion
contentTypeOBLIGATORIOContentTypeTipo de contenido (obligatorio)
textstringContenido de texto de la publicacion
platformTextsPlatformText[]Sobrescrituras de texto por plataforma
mediaUrlsstring[]URLs de archivos multimedia
thumbnailUrlstringURL de miniatura para publicaciones de video
scheduledAtOBLIGATORIOstringFecha de programacion (obligatorio, ISO 8601)
pinterestConfigsPinterestConfig[]Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion
tiktokConfigsTikTokConfig[]Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion
instagramConfigsInstagramConfig[]Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion
facebookConfigsFacebookConfig[]Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion
youtubeConfigsYouTubeConfig[]Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion

Anulaciones de configuracion de plataforma por publicacion

Las configuraciones de plataforma pueden establecerse en dos niveles: nivel de lote (aplicadas a todas las publicaciones como valor predeterminado) y por publicacion (anulan el nivel de lote para esa publicacion especifica). Si una publicacion incluye su propia configuracion de plataforma, reemplaza completamente la configuracion de nivel de lote para esa plataforma.

Límite de tasa

Máximo 100 publicaciones por solicitud. Cada publicación se procesa de forma independiente. Si una falla la validación, las demás se seguirán programando.

Una cuenta por plataforma

Solo se permite una cuenta por plataforma. Todas las publicaciones del lote comparten las mismas conexiones, por lo que no puede incluir multiples IDs de conexion para la misma plataforma. Esta restriccion se aplica para cumplir con los Terminos de Servicio de las plataformas.
Programar publicaciones en masa
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
    }
  ]
}