Reddit API

⭐ Beginner's Pick Social / OAuth Advanced HTTPS

Varies by plan (check documentation)

28 Score

Grade F

Visit Official Site Compare Alternatives

Overview

Reddit API provides access to posts, comments, subreddits, and user data from one of the world's largest discussion platforms. It uses OAuth 2.0 and has a well-documented REST interface, making it a popular choice for social data projects. Note that Reddit updated its API pricing in 2023, so check current rate limits and terms before building production apps.

💡

Beginner Tip

You can test many Reddit endpoints without OAuth by appending .json to any Reddit URL (e.g., reddit.com/r/programming.json) — this is perfect for learning the data structure before setting up full authentication.

Available Data

Use case: Integrate homepage of the internet data into web and mobile applications

Reddit data via REST API

JSON-formatted response data

Requires OAuth authentication

Example Response

JSON Response

{
  "status": "success",
  "data": {
    "result": "Data from Reddit",
    "description": "Homepage of the internet",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

data.children Array of post or comment objects wrapped in kind and data properties

data.children[].data.title Title of the Reddit post

data.children[].data.score Net upvote score (upvotes minus downvotes)

data.children[].data.author Username of the post author

data.children[].data.url URL that the post links to, or the post's own permalink for text posts

data.after Pagination token — pass as the after parameter to get the next page of results

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://www.reddit.com/dev/api";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);