List the comments on an Instagram post

POST/v1/tools/instagram.post.comments/callsNeeds an API key

Returns an Instagram post's top-level comments, with author, likes and reply count, a page at a time. Use it to read how an audience reacts to a post.

Tool instagram.post.comments on Instagram. Contract version 1, released 2026-11-01.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

shortcodestringRequired

The code in the post's address, https://www.instagram.com/p/ followed by it. Take it from posts.shortcode of instagram.user.posts.

Matches ^[0-9A-Za-z_-]{1,12}$.

next_page_tokenstring

Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same shortcode.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`comments`

A list of rows. Always present, possibly empty. The post's top-level comments, in Instagram's own order; replies are not included.

idstringRequired

Instagram's identifier of the comment.

textstring

What the comment says.

published_atstring

When the comment was posted, in ISO 8601.

author_idstring

Instagram's numeric identifier of the author, as a string.

author_usernamestring

The author's handle, without the @.

author_namestring

The author's display name.

author_image_urlstring

Address of the author's profile picture. Instagram's media addresses expire.

author_verifiedboolean

Whether Instagram marks the author as verified.

like_countinteger

reply_countinteger

`pagination`

One object. Can be null. How to fetch the next page. Null on the last page.

next_page_tokenstringRequired

Send as next_page_token to fetch the next page.

curl https://api.voxoria.ai/v1/tools/instagram.post.comments/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"shortcode":"DfISRt1vadT"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/instagram.post.comments/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"shortcode": "DfISRt1vadT"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/instagram.post.comments/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"shortcode": "DfISRt1vadT"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "instagram.post.comments",
    "input": {
      "shortcode": "DfISRt1vadT"
    }
  }
}

200 OKoutputapplication/json

{
  "comments": [
    {
      "id": "18075832364572641",
      "text": "❤️❤️❤️",
      "published_at": "2026-10-30T19:11:06Z",
      "author_id": "21488359905",
      "author_username": "kabootar.as",
      "author_name": "کبوتران رضاقدمی",
      "author_image_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-19/711845510_18131002624719906_7964770417782435733_n.jpg?stp=dst-jpg_e0_s150x150_tt6&_nc_cat=103&ig_cache_key=GIbmbSoiPN4CDWpAAJUvdu1_jIhubmNDAQAB1501500j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=gYjZTqQEcNcQ7kNvwEwoL-W&_nc_oc=AdpZk-Q-55SaRGIz2niL5dQ5Hnq1kB41vpfjgnpbGlB4zP2FHGBLGzIrLY4dSU0LVL4&_nc_ad=z-m&_nc_cid=0&_nc_zt=24&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_gid=Y-PUQuSIFV3buvaSs1VX4A&_nc_ss=723ba&oh=00_AQTgY3qYs7lTievkt3iUidz_lqH3u-kGEmfHnPpnX-LIRw&oe=6AECD8B7",
      "author_verified": false,
      "like_count": 57,
      "reply_count": 1
    },
    {
      "id": "18148958167851555",
      "text": "❤️❤️❤️❤️❤️❤️❤️❤️",
      "published_at": "2026-10-30T19:04:26Z",
      "author_id": "64605410652",
      "author_username": "manvi_boutiqe_bahadurgh",
      "author_name": "🇮🇳मानवी बुटीक बहादुर गढ़🇮🇳",
      "author_image_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-19/825323610_17971974519154653_476446740488625373_n.jpg?stp=dst-jpg_e0_s150x150_tt6&_nc_cat=105&ig_cache_key=GFpwMTHdZyBlatk-AN2cN0HJrZwGbmNDAQAB1501500j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=3urPF690PugQ7kNvwEt1ucH&_nc_oc=AdpduZQ7JFT5QEDcZ5MszCQLb41Uw00AgR0zInwVUkPbme5MGoH5DI8TN2Dhyms0uDk&_nc_ad=z-m&_nc_cid=0&_nc_zt=24&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_gid=Y-PUQuSIFV3buvaSs1VX4A&_nc_ss=723ba&oh=00_AQRJLDiRf26nnYs159WWgoYmBCPJeIUUJi8MjyKD92INfw&oe=6AECA7C7",
      "author_verified": false,
      "like_count": 89,
      "reply_count": 3
    },
    {
      "id": "17926825881200615",
      "text": "🔥🔥🔥🔥😍😍😍😍",
      "published_at": "2026-10-30T19:09:43Z",
      "author_id": "49203643329",
      "author_username": "leila___bh_",
      "author_name": "🍓لـــــیــــLElــــلا🍓",
      "author_image_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-19/782191750_18090558575643330_6960464578271812965_n.jpg?stp=dst-jpg_e0_s150x150_tt6&_nc_cat=110&ig_cache_key=GIZMny7CirBlREVAAGWdlOOniZhgbmNDAQAB1501500j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=bhtDCMnbZugQ7kNvwF3Mvmt&_nc_oc=AdppRDU2Brk1MdyDdi5kBexXzuqjXwLtRqkGzRRw1fK1t6cU3_EyJ7fxaVWqG7-foLg&_nc_ad=z-m&_nc_cid=0&_nc_zt=24&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_gid=Y-PUQuSIFV3buvaSs1VX4A&_nc_ss=723ba&oh=00_AQSLwRCqt_kJ6LlVvHWv029qcDKeECMgs-HLIRJR1r959w&oe=6AECC2E8",
      "author_verified": false,
      "like_count": 60,
      "reply_count": 2
    }
  ],
  "pagination": {
    "next_page_token": "pt1.dGlraHViLWluc3RhZ3JhbS12MjpJazFYQkJvVEV4dGJmVUpEUmdwVEUxVWViQjlCUUVNZlZTdGVOVjVYQ3cwc1B3UkNObTRHQ3hvckh4VkpWMmtNVkE5UkZSTVlHR3NzSlI0VEZpUVVDMzB6UjBCTUp4RmZHalVIVVJzNkZoc1RNVHcyWGpaWkExc25Dd2d3QXpKVkFFUWVIbHN6U1FnRENBTVpFVUVyTFJjcUJERUdPRU1iRFZVQlNoQTlOUndkQ2hraktpWXZMU2N6Q2kwdk1DWXdNQ2NjRFRFMEpTWW5KVFF4SFNFbk5DUVlNRDhwQ2pFbkxTd21LeU1uQ2gwZ0NnTWhQem93Smh3Nk9DWXhJQ2N3SlFvbUl6SXhNVElpSmdvME1DUWpNU2M0QkEwaU1EbzdNRDAwTVIwSkp5YzZKaEk5SXpFSkxTNHdKalV3SkNJZElRb2JKaVlsTkRFY0lpY3hOQ1V3S3owMER5Y3BMQ1VxSWljS0hUQTNQVEVyQkE0MkhUbzdKekVqSnpFMUNTWW5JZzhaSXpBdU9TZy1JeklLUGlzaklpYzBOQ1lOTlNzaE1USW1OQ0lWTVNNak1EVTBQeWtWTlRBcEx5WTVKelFORGpRbk9TRV9KVFExQ1RrNE5Ea3dJQ014R1NJek5pNDFJVGNsRGlZNE5DUWlJeXMtRGlJdlBpd2xMakFqR1JrZ01DNDFLRDBqSWc0Nk96TWlKemcwSlE0MUp5RTFJall3SWhreEp5TThOVGM4S1JrMU5Da19JajAzTkFvT05DYzVJajhwTkRVWktUd3dGekFqSXhzWklqQW1JalVoSzBJT1BqUkNMRkV2VHowcVBoYzRGeGMzTXhNb09qMURIMEliVFJFRlBSdFVCaEFESUFZVlpTbFVFVVl1QlRrQkZoa3FMUjBjS3dNSWZTdFVCRlUtQ3pBQUVqbzdGU1VIUEJzc0NDOVZKRkE1UWhCUVBUWVhFa2s3QndSVUhnVWVRMUFVVVZ4Vk5XZ01YVFpMUFY0b1J5dHRPMVZTVVIxTk9oUTRUUjFYQ0E"
  }
}

The output of a real call, each list cut to 3 items.