Automatio
Social API·5 credits per call

Search Reddit content programmatically.

Search across subreddits or the entire platform using keywords and time filters. Get structured JSON results for monitoring or lead generation in a single POST request.

Try it liveFull API reference
POSTautomatio.ai/api/v1/query{ tool: "reddit_search", params: { query: … } }

Live demo

Try it live.

Change the parameters and run a real request against the endpoint. No account, no key.

Queryrequired
Subreddit
Sort
Time
Limit

Free to try, no account. Costs 5 credits on your own key.

POST /api/v1/query · reddit_search

Run the request to see a live response.

Request
curl -X POST https://automatio.ai/api/v1/query \
  -H "Authorization: Bearer $AUTOMATIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"reddit_search","params":{"query":"web scraping","sort":"relevance","limit":5}}'

How it works

One request, one response.

  1. 1

    Define query

    Send a POST request containing your search terms and optional filters like subreddit or time range to the query endpoint.

  2. 2

    Execute search

    The system processes the request to find matching posts and comments across the platform based on your parameters.

  3. 3

    Receive JSON

    A structured JSON object is returned containing the matching results and metadata for immediate integration into your application.

Capabilities

What you get.

Everything this endpoint does, without running the infrastructure yourself.

Keyword matching

Find posts and comments that contain specific strings or phrases across the platform.

Subreddit scoping

Restrict your search to a specific community by providing the name in the subreddit parameter.

Temporal filtering

Narrow results to specific windows such as the last hour, day, or year to capture recent trends.

Relevance sorting

Organize results by relevance, top performance, or newness to prioritize the most important data.

Pagination support

Navigate through large result sets by using the after parameter to fetch subsequent pages.

Cost of ownership

Build it yourself, or call this.

Both are real options. Here is what each one actually costs you.

Run it yourself

  • Register for official developer credentials and manage OAuth tokens
  • Implement logic to handle rate limits and retries
  • Build custom parsers to handle varying post structures and deleted content

Call the API

  • Access the platform through a single API key in the header
  • Receive standardized JSON responses without writing custom scraping logic
  • Pay only for successful calls with no infrastructure to maintain

Integrate

Built for the language you use.

One HTTP endpoint. Copy the call in your language and go.

example.sh
curl -X POST https://automatio.ai/api/v1/query \
  -H "Authorization: Bearer $AUTOMATIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tool": "reddit_search", "params": { "query": "web scraping" } }'

In production

What people build with it.

Social listening dashboards

Monitor specific keywords or brand mentions across subreddits to track public sentiment. Developers use the JSON results to feed internal alerting systems when specific topics spike in volume.

Market research tools

Aggregate user pain points and feature requests from niche communities. By filtering by top posts in specific subreddits, researchers can identify recurring problems and validated user needs.

Lead generation bots

Identify users asking for recommendations or expressing specific needs. The API returns author and post metadata, allowing systems to flag relevant conversations for direct outreach.

Choosing parameters

Which options matter.

The table below lists what exists. These are the calls worth making deliberately.

sort
Use new when building monitoring tools to ensure you see the latest posts first. Use relevance for broad research where keyword density is more important than timing.
time
This parameter is most effective when sort is set to top or comments. It narrows the scope to content that performed well within a specific window like month or year.
limit
If you are performing broad research, set this to a higher value to reduce the number of calls. Note that extremely high limits may be constrained by platform availability for very niche queries.

Alternatives

When to use something else.

A page that pretends it has no alternatives reads as an advert. These are the other real options.

Official Platform API

The best choice if you need to perform write actions like posting or voting and can manage OAuth 2.0 flows.

PRAW (Python Reddit API Wrapper)

A solid option for Python developers who want a high-level library but are comfortable managing their own official API credentials.

Manual Web Scraping

Appropriate for small, one-off tasks where you do not want to set up any API integration or maintain an account.

Before you integrate

What it does not do.

The boundaries are as useful as the features. These are the ones worth knowing up front.

Public community access

This endpoint only retrieves data from public subreddits. It cannot access private or quarantined communities even if you have personal access to them.

Read-only actions

The API is strictly for data retrieval. It cannot be used to post comments, upvote, downvote, or send direct messages to users.

Deleted content

If a post or comment has been removed by a moderator or deleted by the user, it will not appear in search results. The API only sees what is currently public.

Reference

5 credits per call
Endpoint
POST https://automatio.ai/api/v1/query
Tool ID
reddit_search

Parameters

NameTypeRequiredDescription
querystringSearch query (e.g., "AI news", "best programming languages")
subredditstring—Subreddit to search within (e.g., "programming")
sort"relevance" | "hot" | "top" | "new" | "comments"—Sort order
time"hour" | "day" | "week" | "month" | "year" | "all"—Time filter
limitnumber—Results per page (default: 25)
afterstring—Pagination cursor from previous response

The same endpoints are available over MCP, and the full machine-readable catalogue lives in the API documentation.

Frequently Asked Questions

Find answers to common questions about Reddit Search API

Same data source

Every Reddit endpoint.

One key, one endpoint shape. These all bill per successful call the same way.

Reddit Domain Search API

Retrieve Reddit posts linking to any domain. Filter by popularity or time to track brand mentions and content performance with structured JSON results.

5 credits

Reddit Comments API

Extract Reddit post data, including nested comment threads and author metadata, using a single POST request. Ideal for sentiment analysis and community...

5 credits

Reddit User API

Retrieve Reddit user profiles including karma, account age, and metadata. Access public Reddit user data without OAuth or complex rate limiting.

5 credits

Subreddit API

Extract structured post listings from any public subreddit. Get scores, authors, and timestamps via JSON without managing OAuth2 or complex proxy rotation.

5 credits

Other endpoints

Browse all APIs →
Property Locations API135crAgency Listings API135crReal Estate Agency API135crIdealista Property Search API135crProperty Details API135crLocation Autocomplete API135crCrypto Market Data API5crCrypto Price API3crTwitter Replies API15crTwitter Search API15crTwitter Timeline API15crTwitter User API15crYouTube Video Data API15crYouTube Comments API15crURL to Markdown API1crYouTube Search API15crWeb Search API1crScreenshot API2crYouTube Transcript API15cr
More than just prompts

Supercharge your workflow with AI Automation

Automatio combines the power of AI agents, web automation, and smart integrations to help you accomplish more in less time.

AI Agents
Web Automation
Smart Workflows