REST APIGET

Pontos-chave - 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 associadas ao seu espaco de trabalho. Utilize os IDs de ligacao retornados ao criar publicacoes.

Chave API (Bearer token)

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

Utilizacao

Utilize os valores id desta resposta como IDs de ligacao ao criar publicacoes. Por exemplo, passe twitterConnectionIds com o id da conta Twitter. As contas de paginas do Facebook tambem incluem um pageId (o ID da pagina do Facebook), ja que as paginas nao tem username. No Facebook, pageIds aceita tanto o id da conta como o pageId, e as respostas das publicacoes devolvem sempre 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. Chats do Telegram não aparecem, porque a API não publica no Telegram.

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.

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

Parametro	Tipo	Descricao
`audioType`OBRIGATORIO	`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 integracoes

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>'

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