API Direct

Reddit Posts

GET /v1/reddit/posts

Search Reddit posts by keyword. Returns each post's title, URL, subreddit, author, publication date, text, score, comment count, flair, and video and gallery links. Sort by newest, relevance, hot, top or most commented, narrow to a time window from the past hour to the past year or to one subreddit, and optionally include NSFW posts.

Cost

$0.003 per request

Free tier

50 requests/month

Parameters

query *

Search keyword (max 500 characters)

page

Page number, 1-12 (default: 1). 20 posts per page

sort_by

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

posted_ago

Only posts from this period: 1h, 24h, 7d, 30d, 12m, or all (default: all). Works with every sort_by, e.g. sort_by=relevance&posted_ago=24h for the most relevant posts of the past day

subreddit

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

include_nsfw

Set to true to include posts marked NSFW (left out by default)

get_sentiment

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

Example Request

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

import requests

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

Example Response

{
  "posts": [
    {
      "post_id": "1x8r41q",
      "title": "Trauma Based Programming",
      "url": "https://www.reddit.com/r/Vaporwave/comments/1x8r41q/trauma_based_programming/",
      "date": "2026-10-18 01:48:31",
      "author": "planomania-",
      "author_url": "https://www.reddit.com/user/planomania-",
      "source": "Reddit",
      "domain": "reddit.com",
      "snippet": "Trauma Based Programming",
      "subreddit": "Vaporwave",
      "upvotes": 51,
      "upvote_ratio": 0.93,
      "comments": 5,
      "crossposts": 0,
      "flair": "Video",
      "link_url": "https://v.redd.it/j0e5l6pgs4wh1",
      "thumbnail": "https://external-preview.redd.it/cnYxMDNma2dzNHdoMegLt1Xvsyv80gIh_B9028HKtv_zyFY-Iep2LPcXiPLG.jpeg?width=140&height=107&format=jpg&auto=webp&s=e9624aebe61f11dbf2668c392ad42fe0118d9bd5",
      "is_video": true,
      "nsfw": false,
      "spoiler": false,
      "locked": false,
      "stickied": false,
      "video_url": "https://v.redd.it/j0e5l6pgs4wh1/CMAF_1080.mp4?source=fallback",
      "video_hls_url": "https://v.redd.it/j0e5l6pgs4wh1/HLSPlaylist.m3u8?a=1794925791%2CYzAxYjJlZGNlMGY1MjUxOTVhYjVjYjk3YWIwOTM5YTEzNTRhNzZhZmQ4OWYxNmQ3N2VmNThmNjA2MTAyYmU0OQ%3D%3D&v=1&f=sd",
      "images": [],
      "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"
      }
    }
  ],
  "page": 1,
  "count": 20
}

Your Usage

Free tier this month

Recent Activity