Reddit Market Research Tool
Search Reddit for potential users, pain points, and market opportunities for your projects.
Installation
pip install reddit-market-research
Setup
Create a praw.ini file in your working directory with your Reddit API credentials:
[market_research]
client_id = YOUR_CLIENT_ID
client_secret = YOUR_CLIENT_SECRET
username = YOUR_USERNAME
password = YOUR_PASSWORD
user_agent = market_research by u/YOUR_USERNAME
Get credentials at https://www.reddit.com/prefs/apps (create a "script" app).
Usage
Search Historical Posts
# Basic search (keywords and subreddits required)
reddit-market-research search -s "startups+SaaS" -k "AI tool,help,recommendation"
# JSON output for programmatic use
reddit-market-research search -s "webdev" -k "bug,issue" --json
# Save to CSV
reddit-market-research search -s "programming" -k "help,looking for" --output results.csv
# Time filters and limits
reddit-market-research search -s "fitness" -k "app,tracking" --time year --limit 50
# Load keywords from file
reddit-market-research search -s "startups" --keywords-file keywords.txt --json
Monitor New Posts (real-time)
reddit-market-research monitor -s "startups+SaaS" -k "looking for,need help"
Options
| Flag | Short | Description |
|---|---|---|
--subreddits |
-s |
Subreddits to search (plus-separated) required |
--keywords |
-k |
Keywords to match (comma-separated) |
--keywords-file |
Load keywords from file (one per line) | |
--time |
-t |
Time filter: hour, day, week, month, year, all |
--sort |
Sort: relevance, hot, top, new, comments | |
--limit |
-l |
Max results to display |
--json |
-j |
Output as JSON |
--output |
-o |
Save to file (.csv or .json) |
Output Fields
Each result includes:
title- Post titlebody- First 200 chars of post body (where pain points often live)subreddit- Source subredditscore- Upvotescomments- Comment counturl- Direct link to postcreated- Post timestampauthor- Reddit username
Claude Code Workflow
This tool is designed to be used with Claude Code for market research on GitHub repos:
User: "Research market opportunities for https://github.com/neonwatty/seating-arrangement"
Claude Code:
1. Fetches repo README via WebFetch
2. Analyzes project → generates keywords + subreddits
3. Runs: reddit-market-research search -s "..." -k "..." --json
4. Parses JSON results
5. Summarizes opportunities for user
Example prompts:
- "Find Reddit discussions about problems my seating-arrangement tool could solve"
- "Search for potential users of my meme-search project"
- "What pain points do people have that my youtube-tools repo addresses?"
Development
# Clone and install in development mode
git clone https://github.com/neonwatty/reddit-market-research.git
cd reddit-market-research
pip install -e ".[dev]"
# Run linting
ruff check reddit_monitor.py
# Run formatter
ruff format reddit_monitor.py
# Run type checking
mypy reddit_monitor.py
# Run dead code detection
vulture reddit_monitor.py tests/
# Run tests
pytest tests/ -v
License
MIT
Metadata
Release files for reddit-market-research 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| reddit_market_research-0.3.0.tar.gz | 41.7 kB | Without provenance | Details for reddit_market_research-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| reddit_market_research-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for reddit_market_research-0.3.0-py3-none-any.whl |
Total release size: 50.2 kB
Release files / reddit_market_research-0.3.0.tar.gz
| Download URL | reddit_market_research-0.3.0.tar.gz |
|---|---|
| Size | 41.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9100c1369d17da3f6c65b1b70ccc8ce443390ee8f85e79935ea2fb6ed9203c1c
|
|
BLAKE2b-256 checksum How to use checksums |
fff3fa6ccd79be5e660f767ee7fc49e442bd17503c6b269b1ba4a14d7271f413
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Release files / reddit_market_research-0.3.0-py3-none-any.whl
| Download URL | reddit_market_research-0.3.0-py3-none-any.whl |
|---|---|
| Size | 8.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fbcaf951093f01ac19117d2a00222309b778b53242759df2c96754c72f2f0c9d
|
|
BLAKE2b-256 checksum How to use checksums |
b951892d98be32c74908cb6d662ae093fbe192bd079a12f2e1c0f6c6f3103187
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Security for reddit-market-research 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.