ReddGrowReddGrow Docs
API 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