How do I install the Reddit API skill?

Run npx skillmds@latest add xpozpublic/reddit-api in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Reddit API safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Reddit API?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Reddit API free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Reddit API?

XPOZpublic (@xpozpublic) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Reddit API by xpozpublic — Agent Skill

Name: Reddit API
Author: XPOZpublic

Reddit API

Reddit Search: search posts, comments, users, and subreddits across Xpoz's indexed Reddit archive. Find discussions, track topics, discover communities, and analyze engagement. No Reddit API key needed; works through Xpoz MCP with natural language queries.

XPOZpublic 29782e7 3.5 KB Updated Sep 17, 2026

File contents

Reddit Search

Search Reddit posts and comments at scale without a Reddit API key.

Find discussions, discover subreddits, look up users, and export results — all through Xpoz MCP. No Reddit API credentials needed, no rate limit headaches, no OAuth setup with Reddit.

⚡ Setup

👉 Follow xpoz-setup — handles auth automatically. User just clicks "Authorize" once.

What You Can Search

Tool	What It Does
`getRedditPostsByKeywords`	Search posts by topic
`getRedditCommentsByKeywords`	Search comments (where deep expertise lives)
`getRedditUsersByKeywords`	Find users discussing a topic
`getRedditSubredditsByKeywords`	Discover relevant communities
`getRedditPostsByAuthor`	Get a user's post history
`getRedditUser`	Look up a specific profile
`searchRedditUsers`	Find users by name

Quick Examples

Search Posts

mcporter call xpoz.getRedditPostsByKeywords \
  query="self hosting AND docker" \
  startDate=2026-01-01 \
  limit=100

# Always poll for results:
mcporter call xpoz.checkOperationStatus operationId=op_abc123

Search Comments

Comments often contain the deepest expertise — practitioners sharing real experience:

mcporter call xpoz.getRedditCommentsByKeywords \
  query="kubernetes networking troubleshoot" \
  fields='["id","text","authorUsername","subredditName","score","createdAtDate"]'

Find Subreddits

mcporter call xpoz.getRedditSubredditsByKeywords \
  query="machine learning" \
  limit=30

Look Up a User

mcporter call xpoz.getRedditUser \
  identifier=spez \
  identifierType=username

Boolean Queries

AND, OR, NOT (uppercase)
"exact phrase" for precise matching
() for grouping

mcporter call xpoz.getRedditPostsByKeywords \
  query="(python OR rust) AND \"web scraping\" NOT selenium"

CSV Export

Every search returns a dataDumpExportOperationId. Poll it to get a download URL with the full dataset (up to 64K rows):

mcporter call xpoz.checkOperationStatus operationId=op_datadump_xyz
# → result.url = S3 download link

Why Not Use the Reddit API Directly?

	Reddit API	Xpoz Reddit Search
Auth	OAuth + client ID + secret	One-click Xpoz auth
Rate limits	100 requests/min	Handled automatically
Search quality	Reddit's search is notoriously poor	Full-text indexed, boolean operators
Comments	No keyword search for comments	✅ Full comment search
Export	Manual pagination	One-click CSV (64K rows)
Historical	Limited	Back to 2019

Related Skills

xpoz-social-search — Cross-platform search (Twitter + Instagram + Reddit)
expert-finder — Find domain experts from social data
social-sentiment — Brand sentiment analysis

Website: xpoz.ai • Free tier available • No Reddit API key needed

Built for ClawHub • 2026

---name: reddit-apidescription: Reddit Search: search posts, comments, users, and subreddits across Xpoz's indexed Reddit archive. Find discussions, track topics, discover communities, and analyze engagement. No Reddit API key needed; works through Xpoz MCP with natural language queries.---# Reddit Search**Search Reddit posts and comments at scale without a Reddit API key.**Find discussions, discover subreddits, look up users, and export results — all through Xpoz MCP. No Reddit API credentials needed, no rate limit headaches, no OAuth setup with Reddit.---## ⚡ Setup👉 **Follow [`xpoz-setup`](https://clawhub.ai/skills/xpoz-setup)** — handles auth automatically. User just clicks "Authorize" once.---## What You Can Search| Tool | What It Does ||------|-------------|| `getRedditPostsByKeywords` | Search posts by topic || `getRedditCommentsByKeywords` | Search comments (where deep expertise lives) || `getRedditUsersByKeywords` | Find users discussing a topic || `getRedditSubredditsByKeywords` | Discover relevant communities || `getRedditPostsByAuthor` | Get a user's post history || `getRedditUser` | Look up a specific profile || `searchRedditUsers` | Find users by name |---## Quick Examples### Search Posts```bashmcporter call xpoz.getRedditPostsByKeywords \ query="self hosting AND docker" \ startDate=2026-01-01 \ limit=100# Always poll for results:mcporter call xpoz.checkOperationStatus operationId=op_abc123```### Search CommentsComments often contain the deepest expertise — practitioners sharing real experience:```bashmcporter call xpoz.getRedditCommentsByKeywords \ query="kubernetes networking troubleshoot" \ fields='["id","text","authorUsername","subredditName","score","createdAtDate"]'```### Find Subreddits```bashmcporter call xpoz.getRedditSubredditsByKeywords \ query="machine learning" \ limit=30```### Look Up a User```bashmcporter call xpoz.getRedditUser \ identifier=spez \ identifierType=username```---## Boolean Queries- `AND`, `OR`, `NOT` (uppercase)- `"exact phrase"` for precise matching- `()` for grouping```bashmcporter call xpoz.getRedditPostsByKeywords \ query="(python OR rust) AND \"web scraping\" NOT selenium"```---## CSV ExportEvery search returns a `dataDumpExportOperationId`. Poll it to get a download URL with the full dataset (up to 64K rows):```bashmcporter call xpoz.checkOperationStatus operationId=op_datadump_xyz# → result.url = S3 download link```---## Why Not Use the Reddit API Directly?| | Reddit API | Xpoz Reddit Search ||--|-----------|-------------------|| **Auth** | OAuth + client ID + secret | One-click Xpoz auth || **Rate limits** | 100 requests/min | Handled automatically || **Search quality** | Reddit's search is notoriously poor | Full-text indexed, boolean operators || **Comments** | No keyword search for comments | ✅ Full comment search || **Export** | Manual pagination | One-click CSV (64K rows) || **Historical** | Limited | Back to 2019 |---## Related Skills- **[xpoz-social-search](https://clawhub.ai/skills/xpoz-social-search)** — Cross-platform search (Twitter + Instagram + Reddit)- **[expert-finder](https://clawhub.ai/skills/expert-finder)** — Find domain experts from social data- **[social-sentiment](https://clawhub.ai/skills/social-sentiment)** — Brand sentiment analysis---**Website:** [xpoz.ai](https://xpoz.ai) • **Free tier available** • No Reddit API key neededBuilt for ClawHub • 2026

Frequently asked questions