Unif API Docs

Reddit API

Public-data Reddit endpoints (APP surface).

Public-data Reddit endpoints (APP surface).

When To Use This API

The Reddit API is for agent workflows that need public, platform-native data without writing a custom collector for every task. Use it when a prompt needs evidence from live social records, when a Skill needs repeatable enrichment, or when product code needs the same contract an agent discovered through MCP.

This section lists 10 live Reddit operations from the canonical OpenAPI spec. Each operation page documents the route, method, parameters, response envelope, pagination behavior when available, and the error vocabulary shared across UnifAPI.

  • Read public subreddit, feed, post, comment, and user activity for market and community research.
  • Turn Reddit threads into evidence for social listening, product feedback, and topic discovery agents.
  • Use URL-style subreddit, post, and user identifiers so prompts can move naturally from browser links to API calls.

Agent Contract Notes

Agents usually discover these endpoints with the hosted UnifAPI MCP server, inspect the operation schema, then call only the records needed for the current task. Developers can call the same endpoints over HTTP with an API key, which makes the path from exploratory agent run to production integration direct.

Every successful response uses a stable envelope with a request id, data payload, optional pagination cursor, and billing metadata. Errors use the same closed vocabulary across platforms, so retry logic, user-facing explanations, and cost reporting can stay consistent even when a workflow spans multiple public-data sources.

When you are choosing an operation, start from the public identifier the user already has: a profile username, post id, channel id, subreddit name, search term, or URL-derived slug. Prefer the narrowest endpoint that answers the question, then expand only when the agent needs more evidence. This keeps record usage predictable, makes citations easier to explain, and avoids turning a focused research task into an expensive crawl.

Operations

Feeds

  • GET /reddit/feed/home — Browse Reddit's anonymous home feed — Return posts from Reddit's anonymous (logged-out) home feed, as a cursor-paginated list.
  • GET /reddit/feed/news — Browse Reddit's news feed — Return posts from Reddit's news feed, as a cursor-paginated list.
  • GET /reddit/feed/popular — Browse Reddit's popular feed — Return posts from Reddit's r/popular feed — the cross-community trending surface — as a cursor-paginated list.

Posts

  • GET /reddit/posts/{id}/comments — List Reddit comments on a post — Return the comments on a Reddit post by its t3_ fullname ID, with nested replies flattened into a single list.
  • GET /reddit/posts/{id} — Get a Reddit post by id — Return a single Reddit post by its t3_ fullname ID, including title, body, author, subreddit, score, and comment count.

Subreddits

  • GET /reddit/subreddits/{name} — Get a Reddit subreddit by name — Return a subreddit's profile by name, including its title, description, subscriber count, and rules metadata.

Users

On this page

When To Use This APIAgent Contract NotesOperationsFeedsPostsSubredditsTrending SearchesUsers