FeedMCP

Data APIs / Threads

Threads post replies API

The first batch of replies under a post: text, time, author and likes.

Item Value
Endpoint GET https://api.feedmcp.com/v1/threads/posts/replies/list
ID threads.posts.replies.list
Price $0.003 / call
Returns A page of Comment objects
Auth Authorization: Bearer $FEEDMCP_API_KEY

Returns the first batch of replies (usually 15–20); further pages are not available yet.

Parameters

Name Type Required Description
url string one of Post link
id string one of Post code

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.items is a list of Comment objects, with the same fields on every platform:

Field Type Description
id string Comment ID
platform string Platform
text string | null Comment text
created_at string | null Posted at, ISO 8601, UTC
author.id string | null Commenter ID (none for WeChat comments)
author.name string | null Commenter name
likes number | null Likes (score on Reddit, reactions on Facebook)
reply_count number | null Replies
replies_token string | null Token for this comment’s replies (YouTube only; pass it to the replies endpoint)
rating number | null Stars, 1–5 (TikTok Shop reviews only)
variant string | null Variant bought (TikTok Shop reviews only)
images string[] Buyer photos (TikTok Shop reviews only)
verified_purchase boolean | null Verified purchase (TikTok Shop reviews only)

When you are charged

$0.003 per call that returns data. Not found, no data, bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/threads/posts/replies/list?url=https%3A%2F%2Fwww.threads.com%2F%40beckylouise66%2Fpost%2FDf2f5lKiFDy" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/threads/posts/replies/list",
    params={"url": "https://www.threads.com/@beckylouise66/post/Df2f5lKiFDy"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/threads/posts/replies/list?url=https%3A%2F%2Fwww.threads.com%2F%40beckylouise66%2Fpost%2FDf2f5lKiFDy", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "threads.posts.replies.list",
  "params": {
    "url": "https://www.threads.com/@beckylouise66/post/Df2f5lKiFDy"
  },
  "max_price": "0.003"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "Df2f5lKiFD2",
        "platform": "threads",
        "text": "First frost on the tent this morning 2",
        "created_at": "2025-11-18T19:06:40.000Z",
        "author": {
          "id": "frost.camper",
          "name": "Frost Camper"
        },
        "likes": 355,
        "reply_count": 12
      },
      {
        "id": "Df2f5lKiFD3",
        "platform": "threads",
        "text": "First frost on the tent this morning 3",
        "created_at": "2025-11-18T18:06:40.000Z",
        "author": {
          "id": "frost.camper",
          "name": "Frost Camper"
        },
        "likes": 355,
        "reply_count": 12
      }
    ]
  },
  "page": {
    "next_cursor": null,
    "has_more": false
  },
  "warnings": [],
  "meta": {
    "endpoint": "threads.posts.replies.list",
    "platform": "threads",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.003",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other Threads endpoints

Questions

How much does the Threads post replies endpoint cost?

$0.003 per call that returns data. Not found, no data, bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

A post is its link (threads.com/@user/post/code) or just the code; an account is the username (without the @).

How do I get more items?

When the answer has page.next_cursor, pass it back as cursor for the next page. Each page is billed on its own.

How do I use it from an AI?

Install the MCP server and ask; your AI calls threads.posts.replies.list.