Reddit scraper API · Lovely Router

Search Reddit posts

Reddit posts for a query or subreddit: title, body, score, comments count, author, date.

Get Reddit comments

A Reddit thread's post and comments by URL: text, score, author, date, reply depth.

Hand it to your AI agent

Copy this prompt into Claude Code, Cursor, Codex or any coding agent. It tells the agent where the docs are and how to use your API key.

Use the Lovely Router Reddit data tools to get data for me. They return JSON and are billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools.md and https://lovelyrouter.com/docs/tools/run.md and https://lovelyrouter.com/docs/api/tools.md
- Tools for this:
  - `reddit-search`: Search Reddit posts ($0.0057 / post)
  - `reddit-comments`: Get Reddit comments ($0.00125 / item + $0.01 / call)
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Each tool takes its own input fields: read them with GET https://lovelyrouter.com/v1/tools/<id> (public, no key needed) before the first run.
- If you support MCP, you can instead connect the server https://lovelyrouter.com/mcp (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <describe the data you need and the output format>

Run one from code

How runs, polling and billing work →

curl https://lovelyrouter.com/v1/tools/reddit-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input":{"queries":["best budget mechanical keyboard"],"maxPosts":10,"timeframe":"year"},"max_results":10}'

Each tool page lists its input fields and an example input. Agents can use every tool over MCP: MCP server

Frequently asked questions

What data can I get from Reddit?

2 tools: Search Reddit posts, Get Reddit comments. Each returns JSON and has its own page with its input fields and price.

Is this a Reddit scraper?

Yes. If you searched for a Reddit scraper, a Reddit API or a Reddit comments scraper, this is it: Post search and comment threads from Reddit, as JSON.

How much does it cost to scrape Reddit?

Each tool has its own price per result, from $0.0013. You pay only for results delivered, from a prepaid balance with no subscription.

Do I need a Reddit account or API key?

No. You call the tools with your Lovely Router API key and get JSON back; there is nothing to set up on Reddit.

Can AI agents use these tools?

Yes. Connect Claude Code, Cursor or any MCP client to the Lovely Router MCP server and the agent picks the right tool with suggest_tools and runs it with run_tool.

Can I use the data any way I like?

You are responsible for using the data lawfully, including privacy law when results contain personal data. See the Acceptable Use Policy.

Acceptable Use Policy · Use cases · Pricing