Reddit Research Agent

Research Reddit with natural-language tasks and receive a structured JSON answer. The Actor uses the official redditapis-mcp server for Reddit data and an OpenRouter model selected in the input.

Quick start on Apify

1. Open the Input tab.
2. Enter a research task, or use the example below.
3. Select an OpenRouter model. openrouter/auto is selected by default.
4. Set the output schema and call limit if needed.
5. Click Start. The result is written to the run’s default dataset.

The input form is generated from .actor/input_schema.json, so users can run their own tasks directly from Apify without changing the source code.

Example: WordPress in the last 24 hours

{
  "task": "Son 24 saat içinde Reddit'te WordPress ile ilgili açılmış başlıkları araştır. En fazla 10 Reddit API çağrısı yap. Bulguları Türkçe özetle.",
  "model": "openrouter/auto",
  "output_schema": {"type":"object","properties":{"ozet":{"type":"string"}},"required":["ozet"]},
  "max_tokens": 1200,
  "max_api_calls": 10
}

Input parameters

Parameter	Type	Default	Description
task	string	—	Natural-language research instruction. Required. Include topic, time range, subreddit, language, and desired analysis.
model	select	openrouter/auto	OpenRouter model. The dropdown contains the current catalog plus Auto Router.
output_schema	object	{ "type": "object" }	JSON Schema for the required answer shape.
max_tokens	integer	3000	Maximum generated output tokens; allowed range 128–16000. Larger values can increase LLM cost.
max_api_calls	integer	5	Hard maximum Reddit MCP/API tool calls; allowed range 1–10.

Output schema example

{
  "type": "object",
  "properties": {"ozet": {"type": "string"}},
  "required": ["ozet"]
}

Model selection

The model dropdown is generated from the OpenRouter catalog at deployment time and includes all models returned by OpenRouter plus openrouter/auto. Auto Router selects a suitable model automatically and the run metrics report the actual model and usage. The catalog changes over time; refresh the schema when publishing a new model snapshot.

Billing

This is a pay-per-event Actor. The Actor charges the actual OpenRouter request cost and Reddit API usage, with the configured 25% commission applied before conversion to Apify PPE units.

• Reddit read API call: $0.002.
• reddit_post_visibility: $0.004 because it performs two upstream reads.
• OpenRouter: actual provider-reported request cost.
• Apify applies the event unit price and the user’s maximum run charge. Review the Pricing tab for the active event price and platform-cost treatment.

Data access and safety

Only public Reddit read tools are registered with Agno. Tools that manage the owner’s RedditAPIs account—monitors, webhooks, feedback, account information, and personal home feed—are excluded and cannot be called by the model. Posting, commenting, voting, and direct messages are not exposed by the upstream MCP server.

Do not place API keys in the task or output. Authentication is configured as secret Actor environment variables by the owner.

Limitations

• Results depend on Reddit availability, indexing, deleted content, and the selected model.
• max_api_calls limits MCP tool calls, not posts returned by one endpoint.
• Large tool results increase LLM context and cost; focused tasks are recommended.

Technical details

The Actor runs redditapis-mcp@0.6.1 over stdio, uses Agno for orchestration, and uses OpenRouter through Agno’s OpenRouter integration. The production entrypoint is src.actor.