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 (max 100)

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

Matching posts

[
  {
    "id": "abc123",
    "title": "TypeScript 5.4 released — what's new?",
    "selftext": "string",
    "author": "typescript_fan",
    "created_utc": 1704067200,
    "url": "https://devblogs.microsoft.com/typescript/announcing-typescript-5-4/",
    "permalink": "/r/typescript/comments/abc123/typescript_54_released/",
    "subreddit": "typescript",
    "score": 1247,
    "num_comments": 89,
    "domain": "devblogs.microsoft.com",
    "thumbnail": "string",
    "preview_url": "string",
    "post_hint": "image",
    "is_self": true
  }
]

Batch fetch posts

Fetch multiple posts by ID in a single request. IDs should be Reddit post IDs (e.g., "abc123").

GET
/agent/posts/batch

Authorization

x-api-key<token>

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

In: header

Query Parameters

idsRequiredstring

Comma-separated list of Reddit post IDs

curl -X GET "https://api.reddgrow.ai/agent/posts/batch?ids=abc123%2Cdef456%2Cghi789" \
  -H "x-api-key: <token>"

Requested posts

[
  {
    "id": "abc123",
    "title": "TypeScript 5.4 released — what's new?",
    "selftext": "string",
    "author": "typescript_fan",
    "created_utc": 1704067200,
    "url": "https://devblogs.microsoft.com/typescript/announcing-typescript-5-4/",
    "permalink": "/r/typescript/comments/abc123/typescript_54_released/",
    "subreddit": "typescript",
    "score": 1247,
    "num_comments": 89,
    "domain": "devblogs.microsoft.com",
    "thumbnail": "string",
    "preview_url": "string",
    "post_hint": "image",
    "is_self": true
  }
]

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 (max 100)

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

Post comments

[
  {
    "id": "def456",
    "body": "Great post! I've been using TypeScript for years and this is a game changer.",
    "author": "commenter_user",
    "created_utc": 1704070800,
    "score": 42,
    "permalink": "/r/typescript/comments/abc123/_/def456/",
    "link_id": "t3_abc123",
    "parent_id": "t3_abc123"
  }
]

Find duplicate posts

Find other Reddit posts sharing the same URL as a given post. Useful for cross-posting analysis.

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

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

curl -X GET "https://api.reddgrow.ai/agent/posts/typescript/abc123/duplicates" \
  -H "x-api-key: <token>"

Duplicate posts

[
  {
    "id": "abc123",
    "title": "TypeScript 5.4 released — what's new?",
    "selftext": "string",
    "author": "typescript_fan",
    "created_utc": 1704067200,
    "url": "https://devblogs.microsoft.com/typescript/announcing-typescript-5-4/",
    "permalink": "/r/typescript/comments/abc123/typescript_54_released/",
    "subreddit": "typescript",
    "score": 1247,
    "num_comments": 89,
    "domain": "devblogs.microsoft.com",
    "thumbnail": "string",
    "preview_url": "string",
    "post_hint": "image",
    "is_self": true
  }
]

Meta

Previous Page

Subreddits

Next Page