---
title: "Reddit API: Search Posts & Comments, No App · SocialToAI"
canonical: https://socialtoai.app/platforms/reddit/
updated: 2026-10-30
---

# Reddit API

The Reddit API lets you search posts and read post details, comments, account profiles, an account's posts and the trending list, with no Reddit account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Reddit does not give view counts, so that field is returned as null. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.

- Page: https://socialtoai.app/platforms/reddit/
- Last updated: 2026-10-30
- Last tested: 2026-11-19

## Actions

| Action | What it returns | Selected by | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- | --- |
| `search` | Find posts by keyword: text, author, likes, comment count and publish time. | — | `reddit.search` | 2 | [Reddit Search API](https://socialtoai.app/reddit-search-api.md) |
| `trending` | The posts trending now. | — | `reddit.trending` | 2 | [Reddit Trending API](https://socialtoai.app/reddit-trending-api.md) |
| `trending` | trending topics | `type=trends` | `reddit.trending:trends` | 2 | [Reddit Trending API](https://socialtoai.app/reddit-trending-api.md) |
| `detail` | One post by ID or link: text, author, likes, comment count and publish time. | — | `reddit.detail` | 2 | [Reddit Detail API](https://socialtoai.app/reddit-detail-api.md) |
| `detail` | the transcript of the video | `include=transcript` | `reddit.detail:transcript` | 2 | [Reddit Detail API](https://socialtoai.app/reddit-detail-api.md) |
| `comments` | The comments under one post: text, likes, reply count and time. | — | `reddit.comments` | 2 | [Reddit Comments API](https://socialtoai.app/reddit-comments-api.md) |
| `user_profile` | One account: name, bio and post count. | — | `reddit.user_profile` | 2 | [Reddit User Profile API](https://socialtoai.app/reddit-user-profile-api.md) |
| `user_posts` | The recent posts of one account. | — | `reddit.user_posts` | 2 | [Reddit User Posts API](https://socialtoai.app/reddit-user-posts-api.md) |

Compared with X: Reddit posts also give title and shares but do not give author followers, saves, reposts, views or hashtags; its accounts do not give followers or following.

Lighter for your AI: across 11 interfaces measured on the same recorded data, the platform's raw JSON is about 169,102 tokens and SocialToAI's answers about 27,114, 83% fewer (2026-11-06; the method is on the "How we measure" page).

## Example call

```bash
curl https://socialtoai.app/v1/search \
  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "reddit",
    "query": "saturn rings"
  }'
```

## Only on Reddit

Each one is called by its own op, through `POST /v1/call/{op}`; its full parameters and response fields are on its own page.

### Communities and lists

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| User active communities | Get the communities a Reddit user is active in by username. | `reddit.user_subreddits` | 2 | [Reddit user active subreddits API](https://socialtoai.app/reddit-user-subreddits-api.md) |
| Community profile | Get a Reddit community by its name. | `reddit.subreddit` | 2 | [Reddit subreddit API](https://socialtoai.app/reddit-subreddit-api.md) |
| Community posts | Get a page of the posts of a Reddit community by its name, hot, newest or top score first. | `reddit.subreddit_posts` | 2 | [Reddit subreddit posts API](https://socialtoai.app/reddit-subreddit-posts-api.md) |

## Fields Reddit cannot give

These fields are always null on the calls named, and are listed in the response's `unavailable`.

| Field | On |
| --- | --- |
| `author.name` | search, trending, detail, user_posts |
| `author.verified` | search, trending, detail, user_posts |
| `author.followers` | search, trending, detail, user_posts |
| `metrics.shares` | search |
| `metrics.collects` | search, trending, detail, user_posts |
| `metrics.views` | search, trending, detail, user_posts |
| `metrics.reposts` | search, trending, detail, user_posts |
| `hashtags` | search, trending, detail, user_posts |
| `followers` | user_profile |
| `following` | user_profile |

## What a whole job costs

| The job | How it adds up | Credits | About |
| --- | --- | --- | --- |
| Search 1,000 results on Reddit | usually 7 a page, 143 pages | 286 credits | about $0.95 |
| Read 1,000 Reddit comments | usually 8 a page, 125 pages | 250 credits | about $0.83 |
| Backfill one Reddit account: a list of 200 posts and 20 in full | 8 list pages + 20 full reads | 56 credits | about $0.19 |
| Watch 1 Reddit account daily, at most a month | 10 credits × 31 days | 310 credits | about $1.03 |

Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.

## Ask in your AI

- Which is bigger on Reddit this week: home coffee or matcha? → search, search: 4 credits

- Read the comments on this Reddit post and tell me what people complain about. → detail, comments × 3: 8 credits

- What is trending on Reddit right now? → trending: 2 credits

[Reddit MCP Server](https://socialtoai.app/mcp/reddit.md)

## Ready-made tools that read Reddit

- [Brand buzz](https://socialtoai.app/tools/brand-buzz.md): How people feel about it on each platform, what comes up most, and the posts behind it
- [Comment analysis](https://socialtoai.app/tools/comment-insights.md): The topics in their comments and how big each is, plus questions, buying intent and complaints
- [Account snapshot](https://socialtoai.app/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Creator profile](https://socialtoai.app/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Bulk link data](https://socialtoai.app/tools/batch-stats.md): One row per link with its numbers as they are now. Links that no longer work are marked

## Official API

Reddit offers official Data APIs under its Data API Terms. Using them for commercial purposes, for research beyond the rate limits, or for anything the terms do not expressly permit needs a separate agreement with Reddit, and deriving revenue from them needs Reddit's express written approval.

Source: [Reddit's developer documentation](https://redditinc.com/policies/data-api-terms), checked 2026-10-30.

|  | Who can use it | Cost | Limits | Source |
| --- | --- | --- | --- | --- |
| Reddit Data API | Developers under Reddit's Data API Terms; commercial use, research beyond the rate limits and earning from it need Reddit's agreement. | Commercial terms are agreed with Reddit; its terms page states no public price. | Reddit posted on 2026-09-30: new requests closed on 2026-10-31; API access starts to close on 2027-01-12 for apps and users that have not registered; public access closes in March 2027; RSS feeds stop on 2026-11-13. | [www.reddit.com](https://www.reddit.com/r/redditdev/comments/1wubcvf/moving_data_api_apps_to_the_developer_platform/), checked 2026-11-05 |
| SocialToAI | Anyone with a key; no Reddit account of yours and no review. | From 2 credits a call (≈$0.0067); failed calls are free. | Publicly visible content only; up to 200 items a call. | https://socialtoai.app/pricing.md |

1,000 posts here: about 143 `reddit.search` calls (typically 7 a page), 286 credits, $0.95 at the first pack. [Estimate your cost](https://socialtoai.app/free-tools/api-cost-estimator.md)

[Reddit official API: access, prices and limits](https://socialtoai.app/does-reddit-have-an-api.md)

- [Reddit RSS stops on November 13: what to use instead](https://socialtoai.app/reddit-rss-alternative.md): Swap a subreddit's .rss address for a daily watch's private feed.
- [Comments API, every platform](https://socialtoai.app/comments-api.md): Which platforms give comments, how many a page, at what price.
- [Transcript API, every platform](https://socialtoai.app/transcript-api.md): Which platforms give a transcript, timed or not.
- [How to read Reddit after its free API access ends](https://socialtoai.app/how-to/read-reddit-after-free-api-access-ends.md): what Reddit announced, with sources, and reading Reddit without its API
- [How to track brand mentions on Reddit after RSS ends](https://socialtoai.app/how-to/track-brand-mentions-on-reddit.md): keep Reddit keyword and brand alerts after RSS ends, with a daily watch
- [How to analyze video comments with AI, and keep the original words](https://socialtoai.app/how-to/analyze-comments-with-quotes.md): what comments say, with original words: the tool or your AI, price per platform, a recorded answer
- [How to get the numbers for hundreds of post links at once](https://socialtoai.app/how-to/check-stats-for-many-links.md): the numbers of hundreds of links in one job: prices per platform, what the free credits run, and what it stops for
- [Monitor Reddit every day: keywords and subreddits](https://socialtoai.app/monitors/reddit.md): a Reddit keyword or subreddit, daily, 2 credits a run
- [Monitor brand mentions every day, with the posts behind them](https://socialtoai.app/monitors/brand.md): a brand, daily, across platforms: attitudes and the posts behind them, from 16 credits a run
- [Reddit trending today](https://socialtoai.app/trending/reddit.md): Today's board in one list, refreshed daily.
- [Reddit MCP server](https://socialtoai.app/mcp/reddit.md): Let your AI read Reddit.

[Reddit API changes](https://socialtoai.app/data/reddit-api-changes.md): Every dated change and what it breaks, with sources.
