REST APIGET

API de cuentas de redes sociales

Recupera todas las cuentas de redes sociales conectadas a tu espacio de AdaptlyPost, con plataforma, ID y estado.

GEThttps://post.adaptlypost.com/post/api/v1/social-accounts

Devuelve una lista de todas las cuentas de redes sociales conectadas a su espacio de trabajo. Utilice los ID de conexión devueltos al crear publicaciones.

Clave API (token Bearer)

Permiso:accounts.readRoles y permisos

Uso

Utilice los valores de id de esta respuesta como ID de conexión al crear publicaciones. Por ejemplo, pase twitterConnectionIds con el id de la cuenta de Twitter. Las cuentas de páginas de Facebook también incluyen un pageId (el ID de la página de Facebook), ya que las páginas no tienen username. Para Facebook, pageIds acepta tanto el id de la cuenta como el pageId, y las respuestas de publicaciones siempre devuelven el pageId de Facebook. Cada cuenta incluye además un status: active, o unauthorized cuando la plataforma rechazó su token. Las publicaciones a una cuenta no autorizada se rechazan con 400 hasta que se reconecte en el panel, y unauthorizedReason contiene el mensaje de la plataforma.

Una ubicación del Perfil de Empresa de Google tiene el nombre de la ubicación como displayName y un username vacío. Las cuentas de Instagram traen supportsInstagramAudio, true cuando la cuenta se conectó a través de Facebook, algo necesario para añadir audio a un Reel. Un canal o grupo de Telegram tiene el título del chat como displayName, su @username público sin la @ como username (vacío si el chat no tiene) y un avatarUrl vacío. Un chat del que se quitó el bot de AdaptlyPost aparece como unauthorized.

Volver a comprobar una cuenta

POSThttps://post.adaptlypost.com/post/api/v1/social-accounts/:id/check

Las páginas se comprueban con Facebook automáticamente dos veces al día. Para comprobar una ahora, llama a este endpoint con el id de la cuenta o el pageId de Facebook. Un token rechazado marca la página como unauthorized y dispara account.unauthorized; un token válido borra una marca anterior. La respuesta incluye el status actualizado.

Clave API (token Bearer)

Permiso:accounts.manageRoles y permisos

Solo una clave de Administrador tiene accounts.manage. Conectar, desconectar y volver a comprobar cuentas, elegir páginas y tableros, las preferencias de Pinterest y los enlaces de conexión son solo para Administradores.

Eliminar una cuenta

DELETEhttps://post.adaptlypost.com/post/api/v1/social-accounts/:id

Desconecta la cuenta del workspace, igual que desconectarla en la página Connectors. Se borran sus tokens guardados, se quita de todas las publicaciones pendientes y recurrentes y deja de contar para tu plan. Pasa el id de la cuenta o el pageId de Facebook. Funciona sea cual sea el status de la cuenta, así que puedes limpiar una cuenta unauthorized sin volver a conectarla. La respuesta devuelve el id, platform, displayName y, en Facebook, el pageId de la cuenta eliminada con removed: true. Un id que el workspace no tiene responde 404.

Clave API (token Bearer)

Permiso:accounts.manageRoles y permisos

En Facebook solo se elimina la página indicada; las demás páginas conectadas con el mismo inicio de sesión de Facebook se quedan. Eliminar un canal de YouTube también desactiva sus subidas de respaldo. Eliminar un canal o grupo de Telegram deja de publicar en él, pero el bot sigue en el chat hasta que lo quites en Telegram. Para recuperar una cuenta, vuelve a conectarla.

Buscar audio de Instagram

GEThttps://post.adaptlypost.com/post/api/v1/social-accounts/:id/instagram-audio

Busca música y sonidos originales de Instagram para añadir a un Reel. Omite searchQuery para ver lo que es tendencia y pasa el audioId elegido en instagramConfigs[].audio. Solo funciona con cuentas de Instagram con supportsInstagramAudio: true.

Clave API (token Bearer)

Permiso:posts.draftRoles y permisos

Parámetros de consulta

Parámetro	Tipo	Descripción
`audioType`OBLIGATORIO	`string`	music o original_sound
`searchQuery`	`string`	Filtro por palabra clave, hasta 100 caracteres. Omítelo para ver el audio en tendencia

Campos del audio

Campo	Descripción
`audioId`	Pásalo como instagramConfigs[].audio.audioId
`audioType`	music o original_sound
`title`	El título de la pista
`displayArtist, igUsername`	displayArtist para música, igUsername (el usuario de Instagram de quien lo creó) para un sonido original
`durationMs`	Duración en milisegundos
`coverArtworkUrl, profilePictureUrl`	Portada para música, foto de perfil de quien lo creó para un sonido original
`previewUrl`	Un enlace temporal al archivo de audio para reproducir una vista previa. Caduca en aproximadamente 1,5 días
`instagramUrl`	La página del audio en Instagram
`isAdsEligible`	Si Instagram marca el audio como apto para anuncios

La lista solo incluye audio que Meta autoriza para publicar desde otras apps, que puede no coincidir con lo que muestra la app de Instagram. Una cuenta no conectada a través de Facebook, o una búsqueda que Instagram rechaza, devuelve 400. Un id de cuenta desconocido devuelve 404.

Listar tableros de Pinterest

GEThttps://post.adaptlypost.com/post/api/v1/social-accounts/:id/pinterest-boards

Devuelve en boards todos los tableros en los que una cuenta de Pinterest puede fijar, incluidos los secretos. Pasa el id de un tablero como pinterestConfigs[].boardId, o su nombre como pinterestConfigs[].boardName. Un tablero pertenece a una sola cuenta de Pinterest, así que lista los tableros de cada cuenta en la que publicas.

Clave API (token Bearer)

Permiso:posts.draftRoles y permisos

Campos del tablero

Campo	Descripción
`id`	Pásalo como pinterestConfigs[].boardId
`name`	El nombre del tablero. Puedes pasarlo como pinterestConfigs[].boardName
`description`	La descripción del tablero. Opcional
`privacy`	PUBLIC, PROTECTED o SECRET, tal como lo indica Pinterest. Opcional
`pinCount`	Número de pines del tablero. Opcional

Un id de cuenta que no existe, o que no es una cuenta de Pinterest de este espacio de trabajo, devuelve 404. Una solicitud que Pinterest rechaza devuelve 400, normalmente porque hay que volver a conectar la cuenta.

Listar todas las integraciones

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts \
  --header 'Authorization: Bearer <api-key>'

Comprobar una página de Facebook ahora

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/check \
  --header 'Authorization: Bearer <api-key>'

Eliminar una cuenta

curl --request DELETE \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id> \
  --header 'Authorization: Bearer <api-key>'

Buscar audio de Instagram

curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/instagram-audio?audioType=music&searchQuery=summer' \
  --header 'Authorization: Bearer <api-key>'

Listar tableros de Pinterest

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/pinterest-boards \
  --header 'Authorization: Bearer <api-key>'

200

{
  "accounts": [
    {
      "id": "conn_abc123",
      "platform": "TWITTER",
      "displayName": "Your Handle",
      "username": "@yourhandle",
      "avatarUrl": "https://pbs.twimg.com/profile_images/...",
      "status": "active"
    },
    {
      "id": "conn_def456",
      "platform": "LINKEDIN",
      "displayName": "Your Company",
      "username": "",
      "avatarUrl": "https://media.licdn.com/...",
      "status": "active"
    },
    {
      "id": "conn_ghi789",
      "platform": "INSTAGRAM",
      "displayName": "Your Profile",
      "username": "yourprofile",
      "avatarUrl": "https://scontent.cdninstagram.com/...",
      "status": "active",
      "supportsInstagramAudio": true
    },
    {
      "id": "conn_pqr678",
      "platform": "TELEGRAM",
      "displayName": "Your Channel",
      "username": "yourchannel",
      "avatarUrl": "",
      "status": "active"
    },
    {
      "id": "conn_mno345",
      "platform": "GOOGLE_BUSINESS",
      "displayName": "Your Cafe, Main Street",
      "username": "",
      "avatarUrl": "",
      "status": "active"
    },
    {
      "id": "conn_jkl012",
      "platform": "FACEBOOK",
      "displayName": "Your Page",
      "username": "",
      "avatarUrl": "",
      "status": "unauthorized",
      "unauthorizedReason": "This Page access token belongs to a Page that is not accessible.",
      "pageId": "123456789012345"
    }
  ]
}