> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram API

> Leia em JSON perfis públicos do Instagram, publicações recentes com curtidas e contagem de comentários, publicações e reels individuais, comentários e pesquisas por palavra-chave.

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

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "SOCIAL", "payload": { "platform": "instagram", "action": "profile", "username": "natgeo" } }'
```

Envie a tarefa e depois consulte `GET /v1/async/task/{id}` ou receba o webhook. Veja [Tarefas assíncronas](https://docs.querying.ai/pt/concepts/async-tasks.md).

## Ações

| `action` | O que lê | Obrigatório |
| - | - | - |
| `search` (padrão) | Publicações e reels de uma palavra-chave | `query` |
| `profile` | O perfil de uma conta pública e suas 12 publicações mais recentes | `username` |
| `posts` | As 12 publicações mais recentes de uma conta, cada uma com suas contagens | `username` |
| `post` | Uma publicação ou reel com os primeiros comentários | `postUrl` |
| `comments` | Os comentários de uma publicação | `postUrl` |

`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

```json theme={"theme":"css-variables"}
{
  "platform": "instagram",
  "action": "profile",
  "id": "787132",
  "username": "natgeo",
  "displayName": "National Geographic",
  "biography": "Step into wonder and find your inner explorer with National Geographic.",
  "profileUrl": "https://www.instagram.com/natgeo/",
  "isVerified": true,
  "isPrivate": false,
  "followerCount": 268096466,
  "followingCount": 195,
  "postCount": 32000,
  "hasReels": true,
  "threadsUsername": "natgeo",
  "latestStoryAt": "2026-11-17T15:07:32.000Z",
  "recentPosts": [
    {
      "id": "4032379434794749057",
      "code": "Df147tCiAyB",
      "url": "https://www.instagram.com/p/Df147tCiAyB/",
      "mediaType": "carousel",
      "caption": "National Geographic photographers ventured to places far and wide this year.",
      "imageUrl": "https://scontent.cdninstagram.com/v/t51.82787-15/912032737.jpg"
    }
  ]
}
```

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

* [YouTube](https://docs.querying.ai/pt/engines/youtube.md)
* [Threads](https://docs.querying.ai/pt/engines/threads.md)
* [Visão geral dos motores](https://docs.querying.ai/pt/engines/overview.md)
* [Créditos e limites](https://docs.querying.ai/pt/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.