REST API

Programacion masiva

Programar multiples publicaciones a la vez

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

Parametro	Tipo	Descripcion
`platforms`OBLIGATORIO	`PlatformType[]`	Plataformas objetivo para todas las publicaciones
`timezone`OBLIGATORIO	`string`	Zona horaria IANA para programacion
`posts`OBLIGATORIO	`PostItem[]`	Array de publicaciones a programar (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[]`	Configuraciones de Pinterest a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema
`tiktokConfigs`	`TikTokConfig[]`	Configuraciones de TikTok a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema
`instagramConfigs`	`InstagramConfig[]`	Configuraciones de Instagram a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema
`facebookConfigs`	`FacebookConfig[]`	Configuraciones de Facebook a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema
`youtubeConfigs`	`YouTubeConfig[]`	Configuraciones de YouTube a nivel de lote aplicadas a todas las publicaciones. Consulte Configuraciones de plataforma para el esquema

Campos del elemento de publicacion

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

Post Item Parameters

Parametro	Tipo	Descripcion
`contentType`OBLIGATORIO	`ContentType`	Tipo de contenido (obligatorio)
`text`	`string`	Contenido de texto de la publicacion
`platformTexts`	`PlatformText[]`	Per-platform text overrides
`mediaUrls`	`string[]`	URLs de archivos multimedia
`thumbnailUrl`	`string`	Thumbnail URL for video posts
`scheduledAt`OBLIGATORIO	`string`	Fecha de programacion (obligatorio, ISO 8601)
`pinterestConfigs`	`PinterestConfig[]`	Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion
`tiktokConfigs`	`TikTokConfig[]`	Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion
`instagramConfigs`	`InstagramConfig[]`	Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion
`facebookConfigs`	`FacebookConfig[]`	Anulacion por publicacion. Cuando se establece, tiene prioridad sobre la configuracion a nivel de lote para esta publicacion
`youtubeConfigs`	`YouTubeConfig[]`	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.

Rate limit

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

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

Programacion masiva

Parametros del cuerpo

Campos del elemento de publicacion

Post Item Parameters

AdaptlyPost

Contacto