Saltar para o conteúdo principal
Leia dados públicos do Instagram em JSON pela API de tarefas assíncronas. Envie taskType SOCIAL com platform instagram e escolha o que ler com action. Cada requisição concluída custa 0.5 crédito.

Requisição

Envie a tarefa e depois consulte GET /v1/async/task/{id} ou receba o webhook. Veja Tarefas assíncronas.

Ações

username aceita um nome de usuário ou o URL de um perfil. postUrl aceita o URL de uma publicação, reel ou IGTV, como https://www.instagram.com/p/Df147tCiAyB/.

Parâmetros

  • query: Obrigatório para search. Uma palavra-chave, a palavra de uma hashtag ou o nome de uma marca.
  • limit: Opcional. search aceita de 1 a 30, com padrão 10. posts aceita de 1 a 12, com padrão 12. comments aceita de 1 a 500, com padrão 50.

Exemplo de resposta

Campos do resultado

  • Toda resposta repete platform e action. As listas trazem returnedCount.
  • profile retorna id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, followingCount, postCount, hasReels, highlights, threadsUsername, pronouns e recentPosts. latestStoryAt aparece enquanto a conta tem um story no ar, e isMemorialized marca uma conta transformada em memorial.
  • posts retorna posts, as 12 publicações mais recentes da conta, com likeCount, commentCount e publishedAt lidos da página de cada publicação.
  • post retorna post e os primeiros comments da publicação. Uma publicação tem id, code, url, mediaType (image, video ou carousel), caption, imageUrl, images, videoUrl, width, height, likeCount, commentCount, publishedAt, username, authorFullName, authorIsVerified, authorProfileImageUrl, coauthors, taggedUsers, topics, audio (a música ou o áudio original do autor), hasAudio, captionIsEdited, aiLabel e commentsDisabled.
  • comments retorna comments, cada um com id, text, username, likeCount, replyCount e publishedAt. Um comentário com GIF traz gifUrl. availableCount é a contagem de comentários da publicação, e partial: true marca uma lista menor que essa contagem.
  • search retorna posts com position, o username do autor, authorId, authorIsVerified e authorProfileImageUrl, e playCount nos reels. source é instagram quando o Instagram tem uma página de pesquisa para a palavra-chave, o que acrescenta o title dela, relatedKeywords e o summary do próprio Instagram sobre a palavra-chave, com as sources para onde apontam os números das notas. Para outras palavras-chave, source é web, e posts traz publicações e reels públicos dos últimos 30 dias.
  • O Instagram mostra a um visitante desconectado as 12 publicações mais recentes de um perfil e cerca de uma dúzia de comentários de uma publicação, e posts, post e comments retornam isso. Leia post para obter as contagens e o horário de publicação de um resultado de pesquisa.
  • Uma conta ou publicação que não existe, uma publicação privada ou uma página que o Instagram só mostra a visitantes conectados encerra a tarefa com PAGE_UNAVAILABLE. Só as requisições concluídas são cobradas.

Relacionado