Reddit Comments API

Endpoint

GET /v1/reddit/comments

Parameters

query *

Search keyword (max 500 characters)

pages

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

sort_by

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

Response fields

posts

Array of matching comments

title

Comment title (format: u/username on r/subreddit)

url

Link to the parent post

date

Publication date and time

author

Reddit username

source

Platform name (Reddit (Comment))

subreddit

Subreddit name

snippet

Comment content text

pages

Number of pages fetched

count

Total results returned

Example Request

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

import requests

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

Example Response

{
  "posts": [
    {
      "title": "u/username on r/python",
      "url": "https://reddit.com/r/python/comments/...",
      "date": "2024-01-15 14:30:00",
      "author": "commenter",
      "source": "Reddit (Comment)",
      "subreddit": "python",
      "snippet": "Comment content..."
    }
  ],
  "pages": 2,
  "count": 50
}

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 5 pages (100 comments) in a single API call using the pages parameter.

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 3 simultaneous requests per endpoint per user. If you need more, just get in touch.