# RedditFind Agent Primer

> Agent-first primer for routing, authentication, validation, and 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](https://redditfind.ai/llms.txt): Shortest discovery entry for machines.
- [agents](https://redditfind.ai/agents): Primer that explains routing, inputs, auth, and boundaries.
- [agents.json](https://redditfind.ai/agents.json): Machine routing manifest.
- [openapi.json](https://redditfind.ai/openapi.json): Canonical OpenAPI alias for integrations.
- [examples/index.json](https://redditfind.ai/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](https://redditfind.ai/dashboard?tab=open-api): Create or manage test and live keys.
- [whoami](https://redditfind.ai/api/open/v1/whoami): Verify token owner, environment, and scopes.
- [Open API docs](https://redditfind.ai/en/open-api): 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](https://redditfind.ai/examples/demo-flow.json): 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](https://redditfind.ai/examples/index.json): Directory of official task examples.
- [reply-assistant example](https://redditfind.ai/examples/reply-assistant.json): 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.