Social API·5 credits per call

Get structured Reddit comment threads.

Provide a Reddit post ID to receive parsed comment trees and engagement data. Skip the complexity of handling platform-specific OAuth and nested JSON fragments.

POSTautomatio.ai/api/v1/query{ tool: "reddit_post", params: { postId: … } }

How it works

One request, one response.

  1. 1

    Send Post ID

    Provide the unique alphanumeric ID for the Reddit thread you want to crawl.

  2. 2

    Resolve Thread

    The system fetches the post metadata and the associated comment tree based on your parameters.

  3. 3

    Receive JSON

    You receive a structured response containing the post content and nested comments ready for processing.

Capabilities

What you get.

Everything this endpoint does, without running the infrastructure yourself.

Thread Depth Control

Use commentDepth to limit how many levels of nested replies are returned in a single call to manage payload size.

Custom Comment Sorting

Adjust commentSort to prioritize high-engagement content, newest updates, or Q&A pairs in active threads.

Complete Author Metadata

Capture usernames, contribution timestamps, and score data alongside the text of every comment in the thread.

Structured Nesting

Responses preserve the original thread hierarchy to simplify recursive logic and tree-traversal in your application.

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 platform-specific developer credentials
  • Manage complex OAuth token refresh cycles and session persistence
  • Handle aggressive rate limiting and pagination for deep threads
  • Maintain custom parsers as the platform updates its internal structure.

Call the API

  • Single POST request with a standard Bearer token
  • No platform-specific account registration or app approval required
  • Credits consumed only on successful data retrieval
  • Unified JSON format consistent with other social data tools.

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_post", "params": { "postId": "example" } }'

In production

What people build with it.

Sentiment Analysis

Input a postId from a product announcement thread to analyze user reactions and common pain points. The structured comment data allows for automated scoring of community feedback for market research reports.

Community Monitoring

Track specific discussions by periodically fetching new comments with commentSort set to new. Developers use this to trigger internal alerts when specific brands or keywords appear in high-traffic subreddits.

AI Training Data

Gather high-quality conversational data for LLM fine-tuning by extracting entire commentDepth trees. This is effective for building domain-specific models trained on technical or hobbyist community discussions.

Choosing parameters

Which options matter.

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

postId
This is the unique identifier found in the Reddit URL, usually located between the subreddit name and the post title slug. For example, in /r/technology/comments/18abcde/title/, the ID is 18abcde.
commentLimit
Use this to avoid extremely large payloads on viral threads with thousands of replies. A value of 100 to 200 is usually sufficient for sentiment sampling without bloating the response.
commentDepth
Set this to 1 if you only need top-level responses to a post. Increase the value for deeper analysis of conversational back-and-forth in debate-heavy subreddits.
commentSort
Choose qa for AMA-style threads to prioritize questions with verified answers, or top to retrieve the most popular community contributions first.

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

Best for building interactive bots that post on behalf of users, but requires strict app approval and manual token management.

Local PRAW Scripts

A viable choice for small-scale local research if you already have valid credentials and do not need a scalable cloud interface.

Before you integrate

What it does not do.

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

Private Subreddits

This endpoint cannot access content from private communities or threads that have been deleted or removed by moderators.

Media Content

The response returns URLs for hosted images, videos, or galleries rather than the binary files or raw pixel data itself.

Real-time Polls

While the post body is returned, specific interactive poll options and real-time voting progress may not be fully represented in the JSON schema.

Reference

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

Parameters

NameTypeRequiredDescription
postIdstringPost ID (e.g., "abc123") or full Reddit URL
commentLimitnumberComments to retrieve (default: 30)
commentDepthnumberMax comment nesting depth (default: 3)
commentSort"best" | "top" | "new" | "controversial" | "old" | "qa"Comment sort order

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 Comments API

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