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

> Lee como JSON perfiles públicos de Instagram, publicaciones recientes con me gusta y número de comentarios, publicaciones y reels individuales, comentarios y búsquedas por palabra clave.

Lee datos públicos de Instagram como JSON mediante la API de tareas asíncronas. Envía `taskType` `SOCIAL` con `platform` `instagram` y elige qué leer con `action`. Cada solicitud completada cuesta **0.5 créditos**.

## Solicitud

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

Envía la tarea y luego consulta `GET /v1/async/task/{id}` o recibe su webhook. Consulta [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md).

## Acciones

| `action` | Qué lee | Obligatorio |
| - | - | - |
| `search` (por defecto) | Publicaciones y reels de una palabra clave | `query` |
| `profile` | El perfil de una cuenta pública y sus 12 publicaciones más recientes | `username` |
| `posts` | Las 12 publicaciones más recientes de una cuenta, cada una con sus recuentos | `username` |
| `post` | Una publicación o reel con sus primeros comentarios | `postUrl` |
| `comments` | Los comentarios de una publicación | `postUrl` |

`username` acepta un nombre de usuario o la URL de un perfil. `postUrl` acepta la URL de una publicación, un reel o un IGTV, como `https://www.instagram.com/p/Df147tCiAyB/`.

## Parámetros

* `query`: Obligatorio para `search`. Una palabra clave, la palabra de un hashtag o el nombre de una marca.
* `limit`: Opcional. `search` acepta de 1 a 30, con 10 por defecto. `posts` acepta de 1 a 12, con 12 por defecto. `comments` acepta de 1 a 500, con 50 por defecto.

## Ejemplo de respuesta

```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 del resultado

* Cada respuesta repite `platform` y `action`. Las listas incluyen `returnedCount`.
* `profile` devuelve `id`, `username`, `displayName`, `biography`, `bioLinks`, `avatarUrl`, `profileUrl`, `isVerified`, `isPrivate`, `followerCount`, `followingCount`, `postCount`, `hasReels`, `highlights`, `threadsUsername`, `pronouns` y `recentPosts`. `latestStoryAt` aparece mientras la cuenta tiene una historia publicada, e `isMemorialized` marca una cuenta conmemorativa.
* `posts` devuelve `posts`, las 12 publicaciones más recientes de la cuenta, con `likeCount`, `commentCount` y `publishedAt` leídos de la página de cada publicación.
* `post` devuelve `post` y los primeros `comments` de la publicación. Una publicación tiene `id`, `code`, `url`, `mediaType` (`image`, `video` o `carousel`), `caption`, `imageUrl`, `images`, `videoUrl`, `width`, `height`, `likeCount`, `commentCount`, `publishedAt`, `username`, `authorFullName`, `authorIsVerified`, `authorProfileImageUrl`, `coauthors`, `taggedUsers`, `topics`, `audio` (la canción o el audio original del autor), `hasAudio`, `captionIsEdited`, `aiLabel` y `commentsDisabled`.
* `comments` devuelve `comments`, cada uno con `id`, `text`, `username`, `likeCount`, `replyCount` y `publishedAt`. Un comentario con GIF incluye `gifUrl`. `availableCount` es el número de comentarios de la publicación, y `partial: true` marca una lista más corta que ese número.
* `search` devuelve `posts` con `position`, el `username` del autor, `authorId`, `authorIsVerified` y `authorProfileImageUrl`, y `playCount` en los reels. `source` es `instagram` cuando Instagram tiene una página de búsqueda para la palabra clave, que añade su `title`, `relatedKeywords` y el `summary` propio de Instagram sobre la palabra clave, con las `sources` a las que apuntan los números de sus notas. Para otras palabras clave, `source` es `web` y `posts` contiene publicaciones y reels públicos de los últimos 30 días.
* Instagram muestra a un visitante sin sesión iniciada las 12 publicaciones más recientes de un perfil y alrededor de una docena de comentarios de una publicación, y `posts`, `post` y `comments` devuelven eso. Lee `post` para obtener los recuentos y la hora de publicación de un resultado de búsqueda.
* Una cuenta o publicación que no existe, una publicación privada o una página que Instagram solo muestra a visitantes con sesión iniciada terminan la tarea con `PAGE_UNAVAILABLE`. Solo se cobran las solicitudes completadas.

## Relacionado

* [YouTube](https://docs.querying.ai/es/engines/youtube.md)
* [Threads](https://docs.querying.ai/es/engines/threads.md)
* [Resumen de motores](https://docs.querying.ai/es/engines/overview.md)
* [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md)


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