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

> Lisez en JSON des profils Instagram publics, des publications récentes avec leurs mentions J’aime et leurs nombres de commentaires, une publication ou un reel, des commentaires et des recherches par mot-clé.

Lisez les données publiques d’Instagram en JSON via l’API de tâches asynchrones. Envoyez `taskType` `SOCIAL` avec `platform` `instagram`, et choisissez ce que vous lisez avec `action`. Une requête terminée coûte **0.5 crédit**.

## Requête

```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" } }'
```

Soumettez la tâche, puis interrogez `GET /v1/async/task/{id}` ou recevez son webhook. Voir [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md).

## Actions

| `action` | Contenu lu | Obligatoire |
| - | - | - |
| `search` (par défaut) | Les publications et reels d’un mot-clé | `query` |
| `profile` | Le profil d’un compte public et ses 12 publications les plus récentes | `username` |
| `posts` | Les 12 publications les plus récentes d’un compte, chacune avec ses compteurs | `username` |
| `post` | Une publication ou un reel avec ses premiers commentaires | `postUrl` |
| `comments` | Les commentaires d’une publication | `postUrl` |

`username` accepte un nom d’utilisateur ou l’URL d’un profil. `postUrl` accepte l’URL d’une publication, d’un reel ou d’une vidéo IGTV, comme `https://www.instagram.com/p/Df147tCiAyB/`.

## Paramètres

* `query` : obligatoire pour `search`. Un mot-clé, le mot d’un hashtag ou un nom de marque.
* `limit` : facultatif. `search` accepte de 1 à 30, avec 10 par défaut. `posts` accepte de 1 à 12, avec 12 par défaut. `comments` accepte de 1 à 500, avec 50 par défaut.

## Exemple de réponse

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

## Champs du résultat

* Chaque réponse reprend `platform` et `action`. Les listes portent `returnedCount`.
* `profile` renvoie `id`, `username`, `displayName`, `biography`, `bioLinks`, `avatarUrl`, `profileUrl`, `isVerified`, `isPrivate`, `followerCount`, `followingCount`, `postCount`, `hasReels`, `highlights`, `threadsUsername`, `pronouns` et `recentPosts`. `latestStoryAt` apparaît tant que le compte a une story en ligne, et `isMemorialized` signale un compte commémoratif.
* `posts` renvoie `posts`, les 12 publications les plus récentes du compte, avec `likeCount`, `commentCount` et `publishedAt` lus sur la page de chaque publication.
* `post` renvoie `post` et les premiers `comments` de la publication. Une publication a `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` (le morceau ou le son original de l’auteur), `hasAudio`, `captionIsEdited`, `aiLabel` et `commentsDisabled`.
* `comments` renvoie `comments`, chacun avec `id`, `text`, `username`, `likeCount`, `replyCount` et `publishedAt`. Un commentaire GIF porte `gifUrl`. `availableCount` est le nombre de commentaires de la publication, et `partial: true` signale une liste plus courte que ce nombre.
* `search` renvoie `posts` avec `position`, le `username` de l’auteur, `authorId`, `authorIsVerified` et `authorProfileImageUrl`, ainsi que `playCount` pour les reels. `source` vaut `instagram` quand Instagram a une page de recherche pour le mot-clé, ce qui ajoute son `title`, ses `relatedKeywords` et le `summary` qu’Instagram rédige sur le mot-clé, avec les `sources` vers lesquelles pointent ses numéros de notes. Pour les autres mots-clés, `source` vaut `web`, et `posts` contient des publications et reels publics des 30 derniers jours.
* Instagram montre à un visiteur non connecté les 12 publications les plus récentes d’un profil et une douzaine de commentaires d’une publication, et `posts`, `post` et `comments` renvoient ceux-ci. Lisez `post` pour obtenir les compteurs et l’heure de publication d’un résultat de recherche.
* Un compte ou une publication qui n’existe pas, une publication privée ou une page qu’Instagram ne montre qu’aux visiteurs connectés termine la tâche avec `PAGE_UNAVAILABLE`. Seules les requêtes terminées sont facturées.

## Voir aussi

* [YouTube](https://docs.querying.ai/fr/engines/youtube.md)
* [Threads](https://docs.querying.ai/fr/engines/threads.md)
* [Vue d’ensemble des moteurs](https://docs.querying.ai/fr/engines/overview.md)
* [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md)


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