REST APIGET

API de contas de redes sociais

Recupere todas as contas de redes sociais conectadas ao seu espaço no AdaptlyPost, com plataforma, ID e status.

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

Retorna uma lista de todas as contas de redes sociais conectadas ao seu espaço de trabalho. Use os IDs de conexão retornados ao criar publicações.

Chave API (Bearer token)

Permissão:accounts.readPapéis e permissões

Uso

Use os valores id desta resposta como IDs de conexão ao criar publicações. Por exemplo, passe twitterConnectionIds com o id da conta do Twitter. As contas de páginas do Facebook também incluem um pageId (o ID da página do Facebook), já que as páginas não têm username. No Facebook, pageIds aceita tanto o id da conta quanto o pageId, e as respostas das publicações sempre devolvem o pageId do Facebook. Cada conta também traz um status: active, ou unauthorized quando a plataforma rejeitou o token. Publicações para uma conta não autorizada são recusadas com 400 até ela ser reconectada no painel, e unauthorizedReason traz a mensagem da plataforma.

Um local do Perfil da Empresa no Google tem o nome do local como displayName e um username vazio. Contas do Instagram trazem supportsInstagramAudio, true quando a conta foi conectada pelo Facebook, o que é necessário para adicionar áudio a um Reel. Um canal ou grupo do Telegram tem o título do chat como displayName, o @username público sem o @ como username (vazio quando o chat não tem) e um avatarUrl vazio. Um chat do qual o bot do AdaptlyPost foi removido aparece como unauthorized.

Verificar uma conta novamente

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

As páginas são verificadas no Facebook automaticamente duas vezes por dia. Para verificar uma agora, chame este endpoint com o id da conta ou o pageId do Facebook. Um token rejeitado marca a página como unauthorized e dispara account.unauthorized; um token válido limpa uma marcação anterior. A resposta traz o status atualizado.

Chave API (Bearer token)

Permissão:accounts.managePapéis e permissões

Só uma chave de Administrador tem accounts.manage. Conectar, desconectar e verificar contas de novo, escolher páginas e painéis, preferências do Pinterest e links de conexão são só para Administradores.

Remover uma conta

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

Desconecta a conta do workspace, igual a desconectá-la na página Connectors. Os tokens guardados são apagados, a conta sai de todas as publicações pendentes e recorrentes e deixa de contar para o seu plano. Passe o id da conta ou o pageId do Facebook. Funciona seja qual for o status da conta, então você pode limpar uma conta unauthorized sem reconectá-la. A resposta devolve id, platform, displayName e, no Facebook, o pageId da conta removida com removed: true. Um id que o workspace não tem responde 404.

Chave API (Bearer token)

Permissão:accounts.managePapéis e permissões

No Facebook só a página indicada é removida; as outras páginas conectadas com o mesmo login do Facebook ficam. Remover um canal do YouTube também desliga os uploads de backup dele. Remover um canal ou grupo do Telegram para as publicações nele, mas o bot continua no chat até você removê-lo no Telegram. Para trazer uma conta de volta, conecte-a de novo.

Buscar áudio do Instagram

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

Busca músicas e sons originais do Instagram para adicionar a um Reel. Omita searchQuery para ver o que está em alta e passe o audioId escolhido em instagramConfigs[].audio. Só funciona para contas do Instagram com supportsInstagramAudio: true.

Chave API (Bearer token)

Permissão:posts.draftPapéis e permissões

Parâmetros de consulta

Parâmetro	Tipo	Descrição
`audioType`OBRIGATÓRIO	`string`	music ou original_sound
`searchQuery`	`string`	Filtro por palavra-chave, até 100 caracteres. Omita para ver os áudios em alta

Campos do áudio

Campo	Descrição
`audioId`	Passe como instagramConfigs[].audio.audioId
`audioType`	music ou original_sound
`title`	O título da faixa
`displayArtist, igUsername`	displayArtist para música, igUsername (o usuário do Instagram de quem criou) para um som original
`durationMs`	Duração em milissegundos
`coverArtworkUrl, profilePictureUrl`	Capa para música, foto de perfil de quem criou para um som original
`previewUrl`	Um link temporário para o arquivo de áudio, para tocar uma prévia. Expira em cerca de 1,5 dia
`instagramUrl`	A página do áudio no Instagram
`isAdsEligible`	Se o Instagram marca o áudio como utilizável em anúncios

A lista traz apenas áudios que a Meta liberou para publicação a partir de outros apps, o que pode ser diferente do que o app do Instagram mostra. Uma conta não conectada pelo Facebook, ou uma busca que o Instagram recusa, retorna 400. Um id de conta desconhecido retorna 404.

Listar quadros do Pinterest

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

Retorna em boards todos os quadros em que uma conta do Pinterest pode fixar, incluindo os secretos. Passe o id de um quadro como pinterestConfigs[].boardId, ou o nome dele como pinterestConfigs[].boardName. Um quadro pertence a uma única conta do Pinterest, então liste os quadros de cada conta em que você publica.

Chave API (Bearer token)

Permissão:posts.draftPapéis e permissões

Campos do quadro

Campo	Descrição
`id`	Passe como pinterestConfigs[].boardId
`name`	O nome do quadro. Você pode passá-lo como pinterestConfigs[].boardName
`description`	A descrição do quadro. Opcional
`privacy`	PUBLIC, PROTECTED ou SECRET, como o Pinterest informa. Opcional
`pinCount`	Número de pins no quadro. Opcional

Um id de conta que não existe, ou que não é uma conta do Pinterest neste espaço de trabalho, retorna 404. Uma requisição que o Pinterest recusa retorna 400, geralmente porque a conta precisa ser reconectada.

Listar todas as integrações

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

Verificar uma página do Facebook agora

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

Remover uma conta

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

Buscar áudio do 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 quadros do 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"
    }
  ]
}