Reddit Posts API

Search Reddit posts by keyword. Returns post title, URL, subreddit, author, publication date, and content snippet for each result. Supports multiple sort options including hot and top posts.

Price: $0.003 per request

Free tier: 50 requests/month

Get API Key View example

Endpoint

GET /v1/reddit/posts

Parameters

query *

Search keyword (max 500 characters)

page

Page number, 1-5 (default: 1)

sort_by

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

Response fields

posts

Array of matching posts

title

Post title

url

Direct link to the post

date

Publication date and time

author

Reddit username

source

Platform name (Reddit)

subreddit

Subreddit name

snippet

Post content text

page

Current page number

count

Number of results returned

Example Request

curl "https://api.apidirect.io/v1/reddit/posts?query=programming&page=1&sort_by=hot" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.apidirect.io/v1/reddit/posts",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "query": "programming",
        "page": 1,
        "sort_by": "hot"
    }
)
print(response.json())

Example Response

{
  "posts": [
    {
      "title": "Reddit post title",
      "url": "https://reddit.com/r/programming/...",
      "date": "2024-01-15 14:30:00",
      "author": "redditor",
      "source": "Reddit",
      "subreddit": "programming",
      "snippet": "Post content..."
    }
  ],
  "page": 1,
  "count": 20
}

Frequently asked questions

What's the difference between hot, top, and most_recent?

Hot shows trending posts with recent activity. Top shows highest-voted posts. Most_recent shows posts in chronological order, newest first.

Does the API include NSFW content?

Yes, the Reddit Posts API includes NSFW content.

How fresh is the Reddit data?

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

How does pricing work?

You only pay for successful requests. The Reddit Posts API costs $0.003 per request. 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.