Skip to main content
RedditFind Open API
API Reference

List API Keys

List the API keys for the current account.

GET/api/open/v1/keys

Endpoint Overview

200api_keys:read

List the API keys for the current account.

Authentication

Use this request header: Authorization: Bearer <token>
Required scopes for this endpoint:api_keys:read

Query Parameters

limit
integerDefault: 20

Number of records to return; the server enforces a safe maximum.

Response

200 - application/json
object
string

List response that always returns object=list and a data array.

data
array

Resource array.

object
string

固定为 open_api.key。

id
string

API Key ID。

name
string

API Key 名称。

environment
enum<string>

所属环境。

testlive
scopes
scope[]

当前 Key 具备的 scopes。

status
enum<string>

Key 状态。

activerevoked
tokenPrefix
string

Token 前缀。

tokenLast4
string

Token 后四位。

maskedToken
string

掩码后的 Token 展示值。

createdAt
string

Creation time.

updatedAt
string

Updated time.

lastUsedAt
string | null

最近使用时间。

lastUsedIp
string | null

最近使用 IP。

lastUsedUserAgent
string | null

最近使用的 User-Agent。

revokedAt
string | null

撤销时间。

has_more
boolean

Whether more results are available.

Common Errors

UNAUTHORIZED
error_code

Missing or invalid Bearer token.

RATE_LIMITED
error_code

The current token hit a rate limit.

NOT_FOUND
error_code

当前 API Key 不存在，或已被清理。

Notes

  • 适合在 Agent 启动前读取当前账户已有的 Keys、它们所在环境、具备的 scopes 和最近使用信息。
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.