FeedMCP

Data APIs / Reddit

Reddit post comments API

Top-level comments under a post: text, time, author and score, page by page.

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

Top-level comments only, 8–15 a page. reply_count is null when only some replies were loaded.

Parameters

Name Type Required Description
url string one of Post link
id string one of Post ID
cursor string no Pagination cursor. Leave it out for the first page; pass page.next_cursor for the next. Each page is billed on its own

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.002 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/reddit/posts/comments/list?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fcamping%2Fcomments%2F1y0xw5t%2Fmy_first_time_solo_camping%2F" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/reddit/posts/comments/list",
    params={"url": "https://www.reddit.com/r/camping/comments/1y0xw5t/my_first_time_solo_camping/"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/reddit/posts/comments/list?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fcamping%2Fcomments%2F1y0xw5t%2Fmy_first_time_solo_camping%2F", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "reddit.posts.comments.list",
  "params": {
    "url": "https://www.reddit.com/r/camping/comments/1y0xw5t/my_first_time_solo_camping/"
  },
  "max_price": "0.002"
}

Response

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

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "19swuzxfvww1",
        "platform": "reddit",
        "text": "Which tent is that? 1",
        "created_at": "2025-11-18T21:05:40.000Z",
        "author": {
          "id": "hiker_1",
          "name": "hiker_1"
        },
        "likes": 49,
        "reply_count": 0
      },
      {
        "id": "19swuzxfvww2",
        "platform": "reddit",
        "text": "Which tent is that? 2",
        "created_at": "2025-11-18T21:04:40.000Z",
        "author": {
          "id": "hiker_2",
          "name": "hiker_2"
        },
        "likes": 48,
        "reply_count": 0
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "reddit.posts.comments.list",
    "platform": "reddit",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

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

Other Reddit endpoints

Questions

How much does the Reddit post comments endpoint cost?

$0.002 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 subreddit is the name after r/ (without r/); a post is its link or the short ID after /comments/.

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 reddit.posts.comments.list.