ReddGrowReddGrow Docs
Reddit Intelligence for AI AgentsAPI Reference

Subreddits

Subreddit posts and comment stream

Get post feed

Returns posts from a subreddit's feed, sorted by the specified method.

GET
/agent/subreddits/{name}/posts

Authorization

x-api-key<token>

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

In: header

Path Parameters

nameRequiredstring

Subreddit name (without r/ prefix)

Query Parameters

sortstring

Sort order for posts

Default: "hot"Value in: "hot" | "new" | "top"
limitinteger

Number of posts to return (max 100)

Default: 25Minimum: 1Maximum: 100
tstring

Time filter (only applies when sort=top)

Default: "day"Value in: "hour" | "day" | "week" | "month" | "year" | "all"
curl -X GET "https://api.reddgrow.ai/agent/subreddits/typescript/posts?sort=hot&t=hour" \
  -H "x-api-key: <token>"

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

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

Get comment stream

Returns recent comments from a subreddit.

GET
/agent/subreddits/{name}/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

nameRequiredstring

Subreddit name (without r/ prefix)

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/subreddits/typescript/comments" \
  -H "x-api-key: <token>"

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

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