All APIs

Reddit API

Beta

Read public Reddit data through 20 typed endpoints with shared authentication, caching, and usage tracking.

100 free requests, no card needed.

Endpoints

Everything public on Reddit, 20 operations.

Profiles, posts, comments, and more, grouped by what they read. Each one is one call.

Profiles

5 operations
  • Get a profileGET /v1/reddit/profiles/{identifier}
  • List profile postsGET /v1/reddit/profiles/{identifier}/posts
  • List profile commentsGET /v1/reddit/profiles/{identifier}/comments
  • List moderated subredditsGET /v1/reddit/profiles/{identifier}/moderated
  • List profile trophiesGET /v1/reddit/profiles/{identifier}/trophies

Posts

3 operations
  • Get a postGET /v1/reddit/posts/{identifier}
  • List post commentsGET /v1/reddit/posts/{identifier}/comments
  • List duplicate postsGET /v1/reddit/posts/{identifier}/duplicates

Trending

1 operation
  • List trending postsGET /v1/reddit/trending/posts

Search

3 operations
  • Search postsGET /v1/reddit/search/posts?q={query}
  • Search profilesGET /v1/reddit/search/profiles?q={query}
  • Search subredditsGET /v1/reddit/search/subreddits?q={query}

Domains

1 operation
  • List domain postsGET /v1/reddit/domains/{identifier}/posts

Subreddits

7 operations
  • Get a subredditGET /v1/reddit/subreddits/{identifier}
  • List subreddit postsGET /v1/reddit/subreddits/{identifier}/posts
  • List subreddit rulesGET /v1/reddit/subreddits/{identifier}/rules
  • List wiki pagesGET /v1/reddit/subreddits/{identifier}/wiki-pages
  • Get a wiki pageGET /v1/reddit/subreddits/{identifier}/wiki-pages/{page}
  • List popular subredditsGET /v1/reddit/subreddits/popular
  • List new subredditsGET /v1/reddit/subreddits/new

Post comments return a nested tree. Use depth to control reply levels.

Built for
  • Community research
  • Brand monitoring
  • Content discovery
Known boundaries
  • Public content only.
  • Profile ID lookups work only for profiles fetched by username before.
  • Comment trees support a maximum depth of 10 and do not expose a continuation cursor.

FAQ

Reddit questions.

Can I test without calling Reddit?
Yes. Test keys use deterministic synthetic responses.
Does karma mean followers?
No. Responses keep karma, subscriber counts, and scores separate.

Let your agent wire up Reddit.

Copy one prompt. It has the docs, the spec, and an example request. Your agent reads it and builds against your test key.

Send your agent ahead.

Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.

For agents