API Direct

Reddit User Posts

GET /v1/reddit/user/posts

Get a Reddit user's submitted posts by username or profile URL. Sort by newest, hot, top or controversial, with a time window (past hour to all time) for top and controversial. Returns title, text, subreddit, date, score, upvote ratio, comment count, flair, shared link, video and gallery links and NSFW flags for each post, 25 per page, up to about 1,000 posts.

Cost

$0.003 per page

Free tier

50 requests/month

Parameters

username

Reddit username, with or without u/ (3-20 characters). Provide exactly one of username or url.

url

Reddit profile URL, e.g. https://www.reddit.com/user/spez (max 500 characters). Provide exactly one of username or url.

sort_by

Sort order: most_recent, hot, top, or controversial (default: most_recent)

posted_ago

Time window for sort_by=top or sort_by=controversial: 1h, 24h, 7d, 30d, 12m, or all (default: all). Rejected with any other sort_by.

pages

Number of pages to fetch, 1-40 (default: 1). Each page returns up to 25 posts.

get_sentiment

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

Example Request

curl "https://apidirect.io/v1/reddit/user/posts?username=GallowBoob&sort_by=most_recent&pages=2" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/reddit/user/posts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "username": "GallowBoob",
        "sort_by": "most_recent",
        "pages": 2
    }
)
print(response.json())

Example Response

{
  "posts": [
    {
      "post_id": "fgghrs",
      "title": "‪Everything in balance.‬ ‪Except karma ⬆️‬⬆️⬆️",
      "url": "https://www.reddit.com/user/GallowBoob/comments/fgghrs/everything_in_balance_except_karma/",
      "date": "2020-03-10 16:27:45",
      "author": "GallowBoob",
      "author_url": "https://www.reddit.com/user/GallowBoob",
      "source": "Reddit",
      "domain": "reddit.com",
      "snippet": "‪Everything in balance.‬ ‪Except karma ⬆️‬⬆️⬆️",
      "subreddit": "u_GallowBoob",
      "upvotes": 7949,
      "upvote_ratio": 0.94,
      "comments": 66,
      "crossposts": 6,
      "flair": "",
      "link_url": "https://i.redd.it/41i4qishgvl41.jpg",
      "thumbnail": "https://b.thumbs.redditmedia.com/I4852BZ7_GtmRUfZQki5aAefmUmWDKtd_1Ymqr9UT1I.jpg",
      "is_video": false,
      "nsfw": false,
      "spoiler": false,
      "locked": true,
      "stickied": true,
      "video_url": "",
      "video_hls_url": "",
      "images": [
        "https://i.redd.it/41i4qishgvl41.jpg"
      ],
      "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"
      }
    }
  ],
  "username": "GallowBoob",
  "sort_by": "most_recent",
  "pages": 2,
  "count": 50
}

Your Usage

Free tier this month

Recent Activity