ReddGrowReddGrow Docs
API v1Reference

Reddit

Reddit intelligence — subreddits, posts, users, domains

Poll an async Reddit read: queued | running | completed (result) | failed (error)

GET
/v1/reddit/jobs/{id}

Path Parameters

idRequiredstring

jobId returned by a 202 response

curl -X GET "https://api.reddgrow.ai/v1/reddit/jobs/string"

{ "jobId": string, "status": "queued" | "running" | "completed" | "failed", "result"?: the data the endpoint returns, "error"?: { "status": number, "message": string }, "creditsCharged"?: number (final credits once finished, after unused pages were refunded) }. 404 for an unknown job or another organization's job. Jobs are kept 24 hours; polling costs 0 credits.

Poll an async Reddit read: queued | running | completed (result) | failed (error)

GET
/agent/jobs/{id}

Path Parameters

idRequiredstring

jobId returned by a 202 response

curl -X GET "https://api.reddgrow.ai/agent/jobs/string"

{ "jobId": string, "status": "queued" | "running" | "completed" | "failed", "result"?: the data the endpoint returns, "error"?: { "status": number, "message": string }, "creditsCharged"?: number (final credits once finished, after unused pages were refunded) }. 404 for an unknown job or another organization's job. Jobs are kept 24 hours; polling costs 0 credits.

Get current API key identity and credit balance

GET
/v1/reddit/me
curl -X GET "https://api.reddgrow.ai/v1/reddit/me"

Get current API key identity and credit balance

GET
/agent/me
curl -X GET "https://api.reddgrow.ai/agent/me"

Get subreddit posts feed

GET
/v1/reddit/subreddits/{name}/posts

Path Parameters

nameRequiredunknown

Subreddit name

Query Parameters

tstring

Time filter

Value in: "hour" | "day" | "week" | "month" | "year" | "all"
limitunknown

Max results (default 25, max 100). One page is fetched, so the price is flat.

sortstring
Value in: "hot" | "new" | "top"
curl -X GET "https://api.reddgrow.ai/v1/reddit/subreddits/javascript/posts?t=hour&sort=hot"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get subreddit posts feed

GET
/agent/subreddits/{name}/posts

Path Parameters

nameRequiredunknown

Subreddit name

Query Parameters

tstring

Time filter

Value in: "hour" | "day" | "week" | "month" | "year" | "all"
limitunknown

Max results (default 25, max 100). One page is fetched, so the price is flat.

sortstring
Value in: "hot" | "new" | "top"
curl -X GET "https://api.reddgrow.ai/agent/subreddits/javascript/posts?t=hour&sort=hot"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get recent comment stream from subreddit

GET
/v1/reddit/subreddits/{name}/comments

Path Parameters

nameRequiredunknown

Subreddit name

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

curl -X GET "https://api.reddgrow.ai/v1/reddit/subreddits/javascript/comments"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get recent comment stream from subreddit

GET
/agent/subreddits/{name}/comments

Path Parameters

nameRequiredunknown

Subreddit name

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

curl -X GET "https://api.reddgrow.ai/agent/subreddits/javascript/comments"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Search posts across Reddit

GET
/v1/reddit/posts/search

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

qRequiredunknown

Search query

curl -X GET "https://api.reddgrow.ai/v1/reddit/posts/search?q=typescript+tips"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Search posts across Reddit

GET
/agent/posts/search

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

qRequiredunknown

Search query

curl -X GET "https://api.reddgrow.ai/agent/posts/search?q=typescript+tips"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get comments for a post

GET
/v1/reddit/posts/{subreddit}/{id}/comments

Path Parameters

idRequiredunknown

Post ID

subredditRequiredunknown

Subreddit name

Query Parameters

limitunknown

Max comments (default 25, max 100)

curl -X GET "https://api.reddgrow.ai/v1/reddit/posts/javascript/abc123/comments"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get comments for a post

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

Path Parameters

idRequiredunknown

Post ID

subredditRequiredunknown

Subreddit name

Query Parameters

limitunknown

Max comments (default 25, max 100)

curl -X GET "https://api.reddgrow.ai/agent/posts/javascript/abc123/comments"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get user post history

GET
/v1/reddit/users/{username}/posts

Path Parameters

usernameRequiredunknown

Reddit username

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

curl -X GET "https://api.reddgrow.ai/v1/reddit/users/spez/posts"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get user post history

GET
/agent/users/{username}/posts

Path Parameters

usernameRequiredunknown

Reddit username

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

curl -X GET "https://api.reddgrow.ai/agent/users/spez/posts"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get user comment history

GET
/v1/reddit/users/{username}/comments

Path Parameters

usernameRequiredunknown

Reddit username

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

curl -X GET "https://api.reddgrow.ai/v1/reddit/users/spez/comments"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Get user comment history

GET
/agent/users/{username}/comments

Path Parameters

usernameRequiredunknown

Reddit username

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

curl -X GET "https://api.reddgrow.ai/agent/users/spez/comments"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Find Reddit posts linking to a domain

GET
/v1/reddit/domains/{domain}/mentions

Path Parameters

domainRequiredunknown

Domain to track

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

curl -X GET "https://api.reddgrow.ai/v1/reddit/domains/example.com/mentions"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).

Find Reddit posts linking to a domain

GET
/agent/domains/{domain}/mentions

Path Parameters

domainRequiredunknown

Domain to track

Query Parameters

limitunknown

Max results (default 25, max 100). Credits scale with the Reddit pages needed.

curl -X GET "https://api.reddgrow.ai/agent/domains/example.com/mentions"

Job created, nothing fetched yet. Body: { "jobId": string, "status": "queued" }. Poll GET /v1/reddit/jobs/{jobId} for the result. The credits charged here (X-Credits-Used) are a reservation for the pages the limit can need; unused pages are refunded when the job finishes (creditsCharged).