Reddit Comments API

Endpoint

GET /v1/reddit/comments

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch, 1-10 (default: 1)

sort_by

Sort order: most_recent, relevance, or top (default: most_recent)

subreddit

Only comments from this subreddit, with or without r/ (e.g. Python)

get_sentiment

Set to true to add AI emotion analysis (+$0.001/page)

Response fields

posts

Array of matching comments

comment_id

Comment ID

post_id

ID of the post the comment is on

parent_id

ID of the comment it replies to, or the post ID for a top-level comment (empty when unavailable)

comment_url

Direct link to the comment

title

Comment title (format: username on subreddit)

url

Link for the parent post: its Reddit thread, or the article, image or video a link post shares

date

Publication date and time

author

Reddit username

source

"Reddit (Comment)"

domain

"reddit.com"

subreddit

Subreddit name

snippet

Comment content text

type

"comment"

upvotes

Net upvotes on the comment. null if the score is hidden by the subreddit or unavailable

post_upvotes

Net upvotes on the parent post. null if unavailable

post_comments

Total comments on the parent post. null if unavailable

sentiment

Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)

pages

Number of pages fetched

count

Total results returned

Example Request

curl "https://apidirect.io/v1/reddit/comments?query=python&pages=2&sort_by=relevance" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/reddit/comments",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "python",
        "pages": 2,
        "sort_by": "relevance"
    }
)
print(response.json())

Example Response

{
  "posts": [
    {
      "comment_id": "pfewxa0",
      "post_id": "1x3wfr5",
      "parent_id": "1x3wfr5",
      "comment_url": "https://www.reddit.com/r/TopCharacterTropes/comments/1x3wfr5/comment/pfewxa0/",
      "title": "practicalcabinet on TopCharacterTropes",
      "url": "https://www.reddit.com/gallery/1x3wfr5",
      "date": "2026-10-12 09:25:33",
      "author": "practicalcabinet",
      "source": "Reddit (Comment)",
      "domain": "reddit.com",
      "subreddit": "TopCharacterTropes",
      "snippet": "The Killer Rabbit of Caerbannog, from *Monty Python and the Holy Grail*, was actually played by a more common non-killer rabbit.\n\n![img](et5lcv7t80vh1)",
      "type": "comment",
      "upvotes": 2461,
      "post_upvotes": 12473,
      "post_comments": 1625,
      "sentiment": {
        "emotions": {
          "joy": 40,
          "trust": 55,
          "fear": 0,
          "surprise": 10,
          "sadness": 0,
          "disgust": 0,
          "anger": 0,
          "anticipation": 30
        },
        "dominant_emotion": "trust",
        "emotional_intensity": 5,
        "polarity": "positive"
      }
    }
  ],
  "pages": 2,
  "count": 44
}

Frequently asked questions

How fresh is the Reddit data?

Our Reddit Comments API provides real-time data from Reddit, with results going back multiple years to a few seconds ago.

How many comments are returned per page?

Each page returns approximately 20 comments. You can fetch up to 10 pages (~200 comments) in a single API call using the pages parameter.

Can I search one subreddit?

Yes. Add subreddit=Python (or r/Python) to search only that subreddit's comments.

How does pricing work?

You only pay for successful requests. The Reddit Comments API costs $0.003 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.