ReddGrowReddGrow Docs
Reddit Intelligence for AI AgentsAPI Reference

Posts

Reddit post search and retrieval

Search posts

Search for posts across all of Reddit by keyword. Returns matching posts ranked by relevance.

GET
/agent/posts/search

Authorization

x-api-key<token>

API key starting with rg_. Create one at https://app.reddgrow.ai/settings/api-keys

In: header

Query Parameters

qRequiredstring

Search query

limitinteger

Number of items to return (default 25, max 100). For reads that fetch several Reddit pages, credits scale with the pages needed.

Default: 25Minimum: 1Maximum: 100
curl -X GET "https://api.reddgrow.ai/agent/posts/search?q=TypeScript+generics+tutorial" \
  -H "x-api-key: <token>"

Job created (Matching posts). Poll GET /agent/jobs/{id} for the result; once status is completed, result is a Listing object whose data.children[].data entries are RedditPost.

{
  "jobId": "string",
  "status": "queued"
}

Get post comments

Returns comments for a specific post, sorted by Reddit's default (best).

GET
/agent/posts/{subreddit}/{id}/comments

Authorization

x-api-key<token>

API key starting with rg_. Create one at https://app.reddgrow.ai/settings/api-keys

In: header

Path Parameters

subredditRequiredstring

Subreddit name (without r/ prefix)

idRequiredstring

Reddit post ID

Query Parameters

limitinteger

Number of items to return (default 25, max 100). For reads that fetch several Reddit pages, credits scale with the pages needed.

Default: 25Minimum: 1Maximum: 100
curl -X GET "https://api.reddgrow.ai/agent/posts/typescript/abc123/comments" \
  -H "x-api-key: <token>"

Job created (Post comments). Poll GET /agent/jobs/{id} for the result; once status is completed, result is an array of RedditComment.

{
  "jobId": "string",
  "status": "queued"
}

Meta

Previous Page

Subreddits

Next Page