Reddit API Guide: Access Posts, Comments and Search Data in 2026

The right way to integrate Reddit depends on what your product actually does. A moderation bot installed inside a community, a non-commercial OAuth client, an academic study, and a commercial social-listening product do not have the same access path or responsibilities.

This guide explains the current official Reddit options and shows how to retrieve public posts, comments, subreddit feeds, and search results through SocQ when your application needs a managed, read-only data endpoint.

Quick answer: Use Reddit's official Developer Platform for apps that run on Reddit, and apply for the official Data API when your use case fits its policies. Use SocQ when you need one API key and normalized public Reddit records alongside other social platforms. Neither route gives permission to ignore Reddit's terms, deleted-content requirements, privacy rights, or restrictions on model training.

Access requirements and policies were checked on July 19, 2026. Reddit can change approval rules and limits, so verify the linked official documentation before launching.

Which Reddit API Should You Use?

Reddit now describes several distinct developer interfaces:

Reddit's developer access overview says the Data API is for approved developers and that academic research must use Reddit for Researchers. Commercial use requires Reddit's permission and a contract.

That means an API decision should begin with use-case classification, not a code library.

Official Reddit Data API Requirements in 2026

For eligible free Data API use, Reddit currently requires a registered OAuth token and a descriptive User-Agent. Unauthenticated traffic may be blocked rather than receiving the standard allowance.

The official Reddit Data API Wiki lists a limit of 100 queries per minute per OAuth client ID, averaged over a ten-minute window. Clients should read:

• X-Ratelimit-Used
• X-Ratelimit-Remaining
• X-Ratelimit-Reset

Do not treat 100 QPM as a universal commercial tier. It is the published limit for users eligible for free access. Reddit says commercial use—including paid products, ad-supported products, subscription services, and services sold for fees—requires prior permission. Broader or paid access is handled separately rather than through a public self-serve price table.

Reddit also requires deletion handling. Its current guidance says stored content deleted from Reddit must be deleted from your systems, and author-identifying information associated with a deleted account must be removed. The documentation recommends routinely deleting stored user data and content within 48 hours to make compliance easier.

Official API Authentication Example

An installed or script application usually exchanges its client credentials and user authorization for an OAuth token, then sends that token to oauth.reddit.com.

The simplified request shape looks like this:

curl "https://oauth.reddit.com/r/learnpython/new?limit=25" \
  -H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
  -H "User-Agent: web:socq-guide:v1.0 (by /u/your_username)"

Production clients need to:

1. Register and obtain approval for the correct use case.
2. Implement the applicable OAuth grant.
3. refresh expiring tokens where supported.
4. Send a truthful, unique User-Agent.
5. Respect rate-limit headers and back off before exhaustion.
6. Process removals and policy changes.

Python developers often use PRAW to handle listing objects, pagination and OAuth details. Direct HTTP can be appropriate when you want fewer dependencies, but it does not remove any policy obligation.

Get a Reddit Post by URL with SocQ

SocQ's Reddit Posts API accepts public Reddit post URLs and redd.it short links. It returns normalized title, body, author, community context, timestamps, public media references and visible engagement.

curl -X POST "https://api.socq.ai/v1/reddit/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
    ]
  }'

The request creates an asynchronous task. Store the returned task_id, then poll:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

When the task succeeds, records are in data.results.items. Continue with next_cursor whenever has_more is true.

A post record uses the same high-level shape as other SocQ resources:

{
  "id": "post_id",
  "platform": "reddit",
  "resource": "posts",
  "type": "post",
  "url": "https://www.reddit.com/r/learnpython/comments/post_id/example/",
  "name": "Example post title",
  "text": "Example post body",
  "author": {
    "username": "example_user",
    "name": "example_user"
  },
  "metrics": {
    "upvotes_count": 842,
    "comments_count": 54,
    "upvote_ratio": 0.96
  },
  "created_at": "2026-07-16T08:00:00Z",
  "collected_at": "2026-07-19T08:00:00Z",
  "extra": {
    "tag": "Discussion",
    "community_name": "learnpython"
  }
}

Visible scores are snapshots, not permanent ground truth. Reddit can fuzz vote counts, content can be edited or removed, and a later collection may differ.

Retrieve Reddit Comments

Use the Reddit Comments API when you need the public discussion under known post URLs:

curl -X POST "https://api.socq.ai/v1/reddit/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
    ]
  }'

Normalized comment records include:

• Comment ID, URL and text.
• Public author fields when available.
• Visible upvote and reply counts.
• Source post and community references.
• Parent comment ID when available.
• Publication and collection timestamps.

The current SocQ endpoint does not accept a results_limit input. Do not assume that every visible branch, collapsed reply, deleted comment, moderator-only item or dynamically ranked result will be returned. If complete thread reconstruction is a hard requirement, test representative deep and large threads before choosing a provider.

Get New, Top, or Hot Subreddit Posts

For community monitoring, the Reddit Subreddit Posts API accepts one or more public subreddit URLs. sort_by supports new, top, and hot; results_limit accepts 1 through 2,000 per submitted subreddit.

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/",
      "https://www.reddit.com/r/webdev/"
    ],
    "sort_by": "new",
    "results_limit": 250
  }'

Choose sorting intentionally:

For monitoring, collect new on a schedule and deduplicate by post ID. Use hot or top as a separate discovery view rather than overwriting the chronological feed.

Search Reddit Posts by Keyword

The Reddit Search API accepts a query, a result limit from 1 to 2,000, and a publication window:

curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "\"social listening\" API",
    "results_limit": 500,
    "published_within": "month"
  }'

Supported windows are hour, day, week, month, year, and all.

Search results are ranked discovery results, not a guaranteed exhaustive archive. Query syntax, ranking, availability and indexing can all affect coverage. Run several narrow queries rather than expecting a single broad query to represent the entire conversation.

For brand monitoring, for example, use a query set:

"Acme Cloud"
acmecloud
"Acme API"
"Acme Cloud" pricing
"Acme Cloud" alternative

Store the query in the discovery context so analysts can explain why each record entered the dataset.

Build a Reliable Reddit Monitoring Pipeline

A durable workflow separates collection, storage and analysis:

Query/subreddit registry
        ↓
Scheduled SocQ submissions
        ↓
Task polling with backoff
        ↓
Normalize + deduplicate by Reddit ID
        ↓
Deletion/retention controls
        ↓
Classification, alerts and reporting

Recommended implementation rules:

1. Use stable IDs. URLs and slugs may change; Reddit IDs are better deduplication keys.
2. Keep source context. Store subreddit, query, sort and collection time.
3. Separate snapshots from entities. Metrics change, while the post ID stays stable.
4. Retry tasks, not individual records. Exponential backoff avoids duplicate submissions.
5. Record missing and deleted states. Do not convert absence into an empty but valid post.
6. Minimize personal data. Most analytics do not need long-term author-level histories.
7. Add an erasure path. Your data model should be able to remove content and author references.

Official Reddit API vs SocQ

Choose the official route if your product performs user-authorized actions, moderation, posting, voting, messaging, or deep Reddit-native integrations. Choose SocQ for supported public-data collection when normalized multi-platform records and managed extraction matter more than write access.

Estimate Workload and Cost

Do not compare providers only by “requests.” One request can return one post, a page of comments, or hundreds of subreddit results.

Estimate:

monthly records =
  direct post lookups
  + comments returned
  + subreddit posts returned
  + search results returned

monthly workload =
  schedules × inputs per run × average records per input

Then account for:

• Empty or unavailable results.
• Refresh frequency.
• Search overlap and deduplication.
• Deep comment threads.
• Storage and deletion processing.
• Concurrency and latency requirements.
• Whether only successful results are billable.

Run a representative pilot across small and large communities before projecting annual spend.

Responsible Use and Data Retention

Public availability is not blanket permission for every use. Reddit's current policies restrict commercial access without approval and prohibit using Reddit content for model training without explicit consent. They also impose deletion duties.

Build the following controls before scale:

• Collect only fields needed for the declared purpose.
• Avoid sensitive-person profiling and individual harassment.
• Do not use the API to evade subreddit or account restrictions.
• Preserve source attribution where content is displayed.
• Set short retention periods for raw content.
• Recheck or remove content that is no longer available.
• Protect API keys and audit access to exports.
• Obtain legal review for commercial, research, or high-risk uses.

SocQ is a technical access layer, not a grant of intellectual-property, privacy, research, or commercial rights.

Reddit API FAQ

Is the Reddit API free?

Reddit offers free and paid access depending on the use case. Eligible free Data API clients currently have a published 100 QPM limit per OAuth client ID. Commercial use requires Reddit's permission and may require a contract and fees.

Can I use the Reddit API without OAuth?

Do not design around unauthenticated access. Reddit's current documentation requires registered OAuth tokens and says traffic without OAuth or login credentials will be blocked.

Can I scrape Reddit for AI training?

Reddit says its content may not be used as model-training input without explicit consent. A third-party API does not remove that restriction.

Does SocQ support Reddit comments?

Yes. SocQ has endpoints for direct posts, comments from post URLs, subreddit post discovery, and keyword search.

Can SocQ post, vote, or moderate on Reddit?

No. SocQ's Reddit endpoints collect supported public records. Use Reddit's official developer products for authorized write actions and moderation.

Are Reddit search results exhaustive?

No. Treat search as ranked discovery. Results depend on query, time window, indexing and availability; they are not a complete historical archive.

What happens when a Reddit user deletes content?

Your system should be able to remove the content and related author-identifying information. Reddit's official guidance recommends routinely deleting stored user data and content within 48 hours to simplify compliance.