API Instagram - GET Method /comments

Allows you to retrieve comments indexed for a specific Instagram post. It is designed as a drill-down from GET /posts: first you query the publications of a Worker, and then, for each publication whose comments you want to inspect, you make an additional call to /comments providing the post_id. Each call to /comments is a separate billable query in your plan.

GET Parameters

Sample query structure:

https://instagram.trawlingweb.com/comments?token={APIKEY}&post_id={POST_ID}

Query Parameters

Note — time window: the /comments endpoint uses a default window of 30 days (vs 1 month for /posts), as comments are typically queried over shorter horizons than posts.

Note — recommended flow: first GET /posts/{WORKERID} to obtain the list of Worker publications. Then, for each post_id whose comments you want to analyse, one call to GET /comments?post_id=.... Each call is billed as an independent query.

⚠️ Important — sterile calls are also billed

GET /comments?post_id=X queries the shared repository of comments indexed by TrawlingWeb. If nobody has configured a subtype=comments Worker monitoring the author of the requested post, the endpoint will return:

{ "response": { "data": [], "totalResults": 0, "restResults": 0 } }

… and the call will be billed within your query quota.

To avoid sterile calls, make sure you have at least one Worker with type=instagram and subtype=comments monitoring the authors of the posts whose comments you want to analyse. Worker creation is documented in 04_Workers_Creation.md.

Output Response - RESPONSE

Upon making a request, the endpoint returns a structured response. The wrapper (data, totalResults, restResults, next) is identical to /posts, but the inner shape of each element is different: each data[i] is a comment, not a post.

Comment Data

Comment Author Data

Inherited Data from Parent Post

Important: these fields describe the POST author and the post itself, not the comment author or the comment. They are inherited from the parent post by project convention. If you need to analyse the comment author, do not use user_followers or user_followed — you'll always see those of the media outlet that owns the post.

Worker Data (Geographic Classification)

Request Data

Example response in JSON format:

{
  "data": [
    {
      "id": "3893360753113419201_18022373657822184",
      "comment_id": "18022373657822184",
      "parent_post_id": "3893360753113419201",
      "parent_post_url": "https://www.instagram.com/p/DYH_vofxc3B/",
      "worker_id": "66d3ba29a337dc2ca3f7745be24f5b29.c23551e0",
      "client_id": 1751,
      "country": "BR",
      "lang": "pt",
      "type": "comment",
      "platform": "instagram_comments",
      "text": "😢😢😢😢 Justiça",
      "user_name": "eurosangela.assuncao",
      "user_screen_name": "eurosangela.assuncao",
      "user_profile": "",
      "is_verified": false,
      "user_followers": 218323,
      "user_followed": 235,
      "likes": 0,
      "ad_value": 327.48,
      "published": "2026-05-09T16:40:51.000Z",
      "crawled": 1778599580642,
      "raw": { "...": "..." }
    }
  ],
  "totalResults": 91,
  "restResults": 90,
  "next": "https://instagram.trawlingweb.com/comments?token=...&post_id=3893360753113419201&ts=...&tsi=..."
}

Key Differences vs /posts

Although both endpoints share authentication and wrapper, they serve different entities. These fields have the same name with different meaning:

Best Practices

Recommended usage flow

1. GET /posts/{WORKERID} — obtain the list of Worker publications.
2. For each post_id from the response that you want to analyse:
3. GET /comments?post_id={POST_ID} — obtain that post's comments.

Each call to /comments is billed individually. Only request the post_ids you actually intend to process.

Data Integrity

Each API request can return a maximum of 100 items (standard). If the total comments exceed that cap, you must continue making calls to the URL indicated in the next parameter of each response.

Pagination

When making requests to /comments?post_id=..., the API returns at most 100 results (or 500 for admin tokens). When more exist, a next URL is included to continue.

Coverage

For a comment to appear in this endpoint, somebody must have configured a subtype=comments Worker monitoring the post author. If you request a post_id that nobody monitors, you'll receive data: [] and totalResults: 0 — and the call will be billed. Before drilling down at scale, ensure you have comments Workers configured for the accounts you care about.

Contact

If you have any questions, need assistance, or want to contract or expand your services, please contact us.

SAT (Technical Support):

• SAT Email
• Official Documentation

SAC (Administrative Support):

• SAC Email

Sales (Sales Support):

• Sales Email