Getting Started

Quickstart

Create a test token first, then run your first Community Discovery request.

Create Your API Key

In the current version, token creation lives in the console and is best used with the test environment for initial integration.

Keep your API keys secure

The raw token is shown only once during creation or rotation. Store it in a secure secret manager and never commit it to your repo or frontend code.

Open Console

Open the console to create test/live API keys.

View details

Make Your First API Call

We recommend validating the full flow with Community Discovery first.

Make Your First API Call

BASH

1curl --request POST \2  --url 'https://redditfind.ai/api/open/v1/community-discovery/jobs' \3  --header 'Authorization: Bearer rf_test_xxx' \4  --header 'Content-Type: application/json' \5  --header 'Idempotency-Key: open-api-demo-001' \6  --data '{7  "product_summary": "A tool that helps indie hackers turn Reddit discussions into structured product insights",8  "target_audience": "Indie hackers, SaaS founders, and growth leads",9  "use_cases": [10    "Product validation",11    "Cold-start acquisition",12    "Find high-intent communities"13  ],14  "constraints": [15    "Avoid hard selling",16    "Prioritize value-first participation"17  ],18  "language": "zh"19}'

JSON

1{2  "id": "cdj_01ht1xj7m8k4m9d2",3  "object": "community_discovery.job",4  "status": "queued",5  "progress": 0,6  "stage_message": "Job queued",7  "result_id": null,8  "created_at": "2026-03-06T12:00:00.000Z",9  "updated_at": "2026-03-06T12:00:00.000Z",10  "reused": false11}

Agent demo path

If an agent only needs to verify headers, polling, and JSON parsing, it can use the public demo flow before provisioning a real key.

Safe demo token

Use Bearer rf_test_demo_agent_flow only against /api/open/demo/v1. It validates the request chain with fixed demo content and does not create real jobs.

Agent primer

Read the agent-facing routing contract and copy the safe demo flow steps.

View details

Demo runbook JSON

Machine-readable token, headers, steps, and expected IDs for the demo flow.

View details