Threads replies API

Parameters from the 2026-10-25 specification snapshot; response rows checked against live responses on 2026-11-21

Quick answer

POST /threads/pushs/task with a post URL starts an asynchronous task that collects the replies to that post. Poll GET /threads/pushs/task/{task_id}: data holds the post itself and its replies, and total_count gives the number of rows. Each reply has reply_level (1 for a direct reply, 2 for a reply to a reply), reply_to_author, its own URL, author, text, timestamps and like, reply and share counts; a second-level reply also carries parent_id, the comment_id of the reply it answers. Data is collected by web crawlers from content publicly published on Threads.

What teams use it for

  • See how readers responded to a brand announcement, campaign post or news post, not just what the post said.
  • Follow the conversation under a post through direct replies and replies to replies.
  • Pair with the reactions API to set the replies against the post's view, like and share counts.

Endpoints

Base URL: https://api.infominer.io/api/v2. Send your API key in the auth-header request header.

MethodPathWhat it does
POST /threads/pushs/task Creates a reply collection task from a post URL.
GET /threads/pushs/task/{task_id} Polls a reply task: status, counters, and the post with its replies in data.

Request parameters

POST /threads/pushs/task

ParameterInTypeRequiredDefault / allowedDescription
post_url body string Yes Threads post URL, for example https://www.threads.com/@username/post/{id}.
mask_author body boolean No false Set to true to remove author identity fields from this response. Send it on each GET poll to mask the returned rows.
max_scroll body integer No Scroll limit for the crawl. Integer.
rerun body boolean No Boolean; run the collection again.

GET /threads/pushs/task/{task_id}

ParameterInTypeRequiredDefault / allowedDescription
task_id path string Yes Task ID returned when the task was created.
mask_author query boolean No false Set to true to remove author identity fields from this response. Send it on each GET poll to mask the returned rows.

Response fields

DataFieldsEndpoint
Replies id, comment_id, post_id, url, post_url, root_post_id, parent_id, reply_level, reply_to_author, author, author_id, content, tm, tm_crawler, like_count, reaction_count, comment_count, share_count, is_reply, is_quote GET /threads/pushs/task/{task_id}

Code examples

curl: create the task

curl -X POST https://api.infominer.io/api/v2/threads/pushs/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_url": "https://www.threads.com/@sample_user_1/post/00000000001", "mask_author": false}'

curl: poll the task by ID

curl "https://api.infominer.io/api/v2/threads/pushs/task/$TASK_ID?page=1&per_page=1000" \
  -H "auth-header: YOUR_API_KEY"

Python (requests): create, poll, read

import time
import requests

BASE_URL = "https://api.infominer.io/api/v2"
HEADERS = {"auth-header": "YOUR_API_KEY"}

# 1. Create the task
resp = requests.post(
    f"{BASE_URL}/threads/pushs/task",
    headers=HEADERS,
    json={
        "post_url": "https://www.threads.com/@sample_user_1/post/00000000001",
        "mask_author": False,
    },
    timeout=30,
)
resp.raise_for_status()
task = resp.json()

# 2. Poll until the task leaves INIT / RUNNING
for _ in range(120):
    resp = requests.get(
        f"{BASE_URL}/threads/pushs/task/{task['id']}",
        headers=HEADERS,
        params={
            "page": 1,
            "per_page": 1000,
        },
        timeout=30,
    )
    resp.raise_for_status()
    result = resp.json()
    status = result.get("status") or result.get("task", {}).get("status")
    if status not in ("INIT", "RUNNING"):
        break
    time.sleep(15)
else:
    raise SystemExit("task still running; poll it again later")

if status == "FAILED":
    raise SystemExit("task failed")
if status != "DONE":
    print("task ended with status", status, "- results may be incomplete")

# 3. Read the records (use page / per_page to fetch further pages)
for row in result.get("data", []):
    print(row.get("reply_level"), row.get("author"), (row.get("content") or "")[:60])

Sample response

Illustrative data written by hand: accounts are sample_user_n and IDs are obviously fake. Field names follow live API responses checked on 2026-11-21; the sample shows a subset of the fields.

Poll response once the task is DONE (illustrative data)

{
  "id": "00000000-0000-4000-8000-000000000001",
  "status": "DONE",
  "post_url": "https://www.threads.com/@sample_user_1/post/00000000001",
  "total": 2,
  "completed": 2,
  "partial": false,
  "timed_out": false,
  "failed_articles": 0,
  "failed_pages": 0,
  "total_count": 3,
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000003",
      "post_id": "00000000001",
      "root_post_id": "00000000001",
      "url": "https://www.threads.com/@sample_user_1/post/00000000001",
      "author": "sample_user_1",
      "author_id": "0000000001",
      "content": "週末走了一條不太熱門的步道,沿途視野很開闊,建議早點出發避開人潮",
      "tm": 1781056800,
      "tm_crawler": 1781143200,
      "like_count": 34,
      "reaction_count": 34,
      "comment_count": 2,
      "share_count": 1,
      "is_reply": false,
      "is_quote": false,
      "reply_to_author": ""
    },
    {
      "id": "00000000-0000-4000-8000-000000000004",
      "comment_id": "00000000002",
      "post_id": "00000000-0000-4000-8000-000000000003",
      "post_url": "https://www.threads.com/@sample_user_1/post/00000000001",
      "root_post_id": "00000000001",
      "url": "https://www.threads.com/@sample_user_2/post/00000000002",
      "reply_level": 1,
      "reply_to_author": "sample_user_1",
      "author": "sample_user_2",
      "author_id": "0000000002",
      "content": "請問這條步道雨天好走嗎?下週想安排家人一起去",
      "tm": 1781060400,
      "tm_crawler": 1781143200,
      "like_count": 3,
      "reaction_count": 3,
      "comment_count": 1,
      "share_count": 0,
      "is_reply": true,
      "is_quote": false
    },
    {
      "id": "00000000-0000-4000-8000-000000000005",
      "comment_id": "00000000003",
      "post_id": "00000000-0000-4000-8000-000000000003",
      "post_url": "https://www.threads.com/@sample_user_1/post/00000000001",
      "root_post_id": "00000000001",
      "parent_id": "00000000002",
      "url": "https://www.threads.com/@sample_user_1/post/00000000003",
      "reply_level": 2,
      "reply_to_author": "sample_user_2",
      "author": "sample_user_1",
      "author_id": "0000000001",
      "content": "下雨後石階會比較滑,建議穿防滑的鞋子",
      "tm": 1781064000,
      "tm_crawler": 1781143200,
      "like_count": 1,
      "reaction_count": 1,
      "comment_count": 0,
      "share_count": 0,
      "is_reply": true,
      "is_quote": false
    }
  ]
}

Limits and notes

  • data includes the post the task was created from as one row, alongside its replies.
  • Poll responses are paginated: send page and per_page on the GET request (per_page defaults to 1000, the maximum). Each response reports page, per_page and total_count, the number of rows collected so far; read further pages until you have total_count rows.
  • reply_level marks the depth: 1 for a direct reply, 2 for a reply to a reply.
  • max_scroll must be an integer.
  • Volume per post and refresh frequency are confirmed per project scope.
Collection: web crawlers collect content publicly published on each platform. Whether this suits your use depends on the purpose and jurisdiction and is for the buyer's legal team to assess; we can provide a description of sources and collection methods.

More Threads API pages

Request a trial

In the request form below, mention Threads and tell us the keywords or accounts, whether you need replies and reactions, and whether author fields should be masked. We confirm the scope and reply with the arrangements for the trial and API key.

Fill in the form to request a trial. We confirm the scope and reply with trial and integration arrangements.

Fill in the request form

FAQ

Which URL does post_url take?
The URL of the Threads post, in the form https://www.threads.com/@username/post/{id}.
How do replies link to the post and to each other?
Every reply row has post_url and root_post_id for the post the task was created from. A second-level reply also has parent_id, which equals the comment_id of the reply it answers.
Can I collect the replies to many posts?
Create one reply task per post URL. Post URLs come from the url field of keyword search or timeline rows.
How is the data collected? Is this the official Threads API?
By web crawlers, from content publicly published on Threads. LargitData is not affiliated with Meta or Threads, and this is not Meta's Threads API. Whether this suits your use depends on the purpose and jurisdiction and is for your legal team to assess; we can provide a description of sources and collection methods.