Canonical agent docs
RedditFind Agent Primer
Agent-first primer for routing, authentication, output validation, and operational boundaries.
What RedditFind is
RedditFind is a Reddit signal discovery, research, and execution coordination tool for growth, research, and go-to-market teams.
Its operating model is: find signals, read signals, track signals, and turn those signals into the next action.
Start here
- llms.txt Shortest discovery entry for machines.
- agents Primer that explains routing, inputs, auth, and boundaries.
- agents.json Machine routing manifest.
- openapi.json Canonical OpenAPI alias for integrations.
- examples/index.json Official examples directory for output validation.
Choose the right workflow
- Community discovery: Use when the user does not yet know which subreddits matter and needs a ranked shortlist backed by evidence threads. Primary UI: https://redditfind.ai/en/subreddit-discovery
- Community overview: Use when target communities are already known and the user needs rules, tone, high-performing content patterns, and participation risk. Primary UI: https://redditfind.ai/en/subreddit-analysis
- Post monitoring: Use when the user already knows keywords or communities and needs an ongoing queue of fresh, triaged threads. Primary UI: https://redditfind.ai/en/reddit-post-monitoring
- Reply assistant: Use when discovery, overview, or monitoring context already exists and the user needs the next best action or an editable response draft with lower execution risk. Primary UI: https://redditfind.ai/en/reddit-ai-agent
Minimum inputs we need
- Community discovery required: product, audience, goal
- Community discovery optional: constraints, timeframe
- Community overview required: subreddit, objective
- Community overview optional: include_rules, force_refresh
- Post monitoring required: goal
- Post monitoring optional: keywords, subreddits, replyGuardrails
- Reply assistant required: context, objective
- Reply assistant optional: guardrails
How to authenticate and call
- Open API console Create or manage test and live keys.
- whoami Verify token owner, environment, and scopes.
- Open API docs Human-readable quickstart, auth, and errors guidance.
- Create or retrieve an API key from the Open API console.
- Call /api/open/v1/whoami before business endpoints.
- Confirm token owner, environment, and scopes.
- Create jobs first, then read job, result, or hits resources.
- Send Idempotency-Key on create requests when possible.
Try a safe demo flow
If you only need to prove your HTTP client, headers, polling, and JSON parsing work, start with the public demo flow before provisioning a real key.
- demo-flow runbook Machine-readable JSON with exact headers, steps, and expected IDs.
- Demo token: rf_test_demo_agent_flow
- Demo base path: https://redditfind.ai/api/open/demo/v1
- Call GET https://redditfind.ai/api/open/demo/v1/whoami first.
- Then run POST https://redditfind.ai/api/open/demo/v1/community-discovery/jobs -> GET https://redditfind.ai/api/open/demo/v1/community-discovery/jobs/cdj_demo_001 -> GET https://redditfind.ai/api/open/demo/v1/community-discovery/jobs/cdj_demo_001/result
- The demo response is fixed and does not represent live data, persisted jobs, or account billing.
- After the demo flow succeeds, switch to a real rf_test_ token from the Open API console and move to /api/open/v1.
How to validate outputs
Use the official examples only after routing and contract selection are already clear.
- examples/index.json Directory of official task examples.
- reply-assistant example Canonical example for the most execution-sensitive workflow.
Boundaries and non-goals
- Human review is required before any public engagement.
- RedditFind does not auto-post to Reddit.
- RedditFind does not automate bulk direct messages.
- Examples validate structure, not live freshness or permission to engage publicly.