Skip to main content
RedditFind Open API
Guides

Authentication & Environments

Understand Bearer tokens, scopes, test/live environments, and idempotency for write operations.

Bearer Token

  • All public endpoints use Authorization: Bearer <token>.
  • Only a hash of the token is stored. The raw token is shown once during creation or rotation.
  • Missing tokens return UNAUTHORIZED (401).
Bearer Token
BASH
1curl --request GET \2  --url 'https://redditfind.ai/api/open/v1/usage' \3  --header 'Authorization: Bearer rf_test_xxx'

OpenClaw Skill Auth

  • If the caller is AI / OpenClaw, use the CLI auth bridge: skill-auth/start -> approve -> poll -> exchange.
  • The browser only handles one login and approval. The CLI then completes polling, token exchange, and secure storage automatically.
  • This layer avoids manual token copying and lets AI centralize timeout, retry, and revoke handling.

Environments

  • Test tokens use the rf_test_ prefix and are ideal for integration, SDK development, and internal validation.
  • Live tokens use the rf_live_ prefix and are intended for external production traffic.
  • Use separate test and live keys across different systems and deployment environments.

Scopes

access:read
scope

Read the current token identity and environment information.

access:write
scope

Rotate or revoke the current integration credential.

api_keys:read
scope

List existing API keys for the current account.

api_keys:write
scope

Create, rotate, or revoke a specific API key.

community_discovery:read
scope

Read Community Discovery jobs and results.

community_discovery:write
scope

Create and cancel Community Discovery jobs.

community_overview:read
scope

Read Community Overview jobs and results.

community_overview:write
scope

Create and cancel Community Overview jobs.

monitoring:read
scope

Read monitoring jobs and hit results.

monitoring:write
scope

Create, enable/disable, and delete monitoring jobs.

usage:read
scope

Read the usage summary.

Idempotency

Recommended header

Use a stable business-side unique value such as a ticket ID, user action ID, or request UUID.

  • Always send Idempotency-Key with POST write operations.
  • When network retries or duplicate submissions happen, the server prefers reusing the existing job.
  • Community Discovery and Community Overview already support idempotent reuse.
Was this page helpful?

Search API Docs

Full-text search across pages, sections, endpoints, and fields

Agent entry

If you are an agent, do not look for a separate manual first. RedditFind now keeps one shortest discovery index, one routing contract, and one API contract.

Use llms-index.txt to discover the stack quickly, agent-overview.json to route the job, and the OpenAPI spec when the workflow needs authenticated programmatic access.

Public demos still matter, but only for validating result shapes after the contracts are clear.

Why this stack is stronger now

  • Semantic detection layers Reddit discussions by demand, complaints, comparisons, and opportunities instead of relying on keywords alone.
  • The Reddit assistant connects discovery, analysis, monitoring, and next actions so agents do less manual orchestration.
  • With the Open API, agents can create jobs, read results, and plug RedditFind into their own workflows through a formal contract instead of guessing UI behavior.

Route by user objective

  • Community discovery — Use when the user still does not know where demand, competitors, or relevant communities live. Open feature page
  • Subreddit analysis — Use when target communities are already known and the user needs rules, tone, content patterns, and risks. Open feature page
  • Post monitoring — Use when the user needs an ongoing queue of new opportunities, feedback signals, or high-intent threads. Open feature page
  • Reddit assistant — Use when discovery, analysis, or monitoring context already exists and the user needs the next best action with lower execution risk. Open feature page

Core contracts and validation

Boundaries and non-goals

  • RedditFind does not auto-post to Reddit.
  • Human review is required before any public reply or post.
  • RedditFind does not support bulk direct-message automation.
  • It is not a generic web search engine or an autonomous posting bot that bypasses human oversight.
  • The Open API creates RedditFind jobs and reads results. It does not bypass human review for public Reddit engagement.