Skip to main content
GET
List Instagram media
Use este endpoint para descobrir os posts ou os stories de uma conta do Instagram. Informe o UUID da conta no caminho e surface na query string. Sua chave de API precisa do escopo automations:read e de acesso a essa conta. surface é obrigatório e aceita posts ou stories. Cada item traz id, surface, media_type, caption, thumbnail_url, instagram_url, published_at, like_count e comments_count. Todos os campos, exceto id e surface, podem vir como null quando o Instagram não devolve um valor.

Referencie uma publicação em um gatilho

Um gatilho de comentário pode ser vinculado a um post. Use um id retornado como valor da referência:
Um gatilho de comentário também aceita o endereço público de um post. Envie url como type da referência e o endereço como value. Um gatilho de resposta ou de reação a story aceita somente o tipo de referência id, então este endpoint é o caminho para vinculá-lo. Leia Atualizar uma automação para conhecer o formato completo do gatilho.

Pagine os resultados

Defina limit como um inteiro de 1 a 50. Quando next_cursor for uma string, envie o mesmo valor como cursor para pedir a próxima página. Um next_cursor igual a null indica que a lista terminou. Esta leitura não altera nenhuma automação, então pode ser repetida com segurança. Quando o Instagram não pode ser acessado, a API retorna 503 com api_instagram_media_unavailable. Essa resposta é temporária e não significa que a conta ficou inacessível.

Exemplo de requisição

Autorizações

Authorization
string
header
obrigatório

Levios API key sent as a Bearer token.

Parâmetros de caminho

accountId
string<uuid>
obrigatório

Parâmetros de consulta

cursor
string
limit
string
surface
enum<string>
obrigatório
Opções disponíveis:
posts,
stories

Resposta

Successful response.