ReddGrowReddGrow Docs
API Reference

Users

Reddit user profile and history

Get user profile

Returns profile information for a Reddit user — karma, account age, and more.

GET
/agent/users/{username}

Authorization

x-api-key<token>

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

In: header

Path Parameters

usernameRequiredstring

Reddit username (without u/ prefix)

curl -X GET "https://api.reddgrow.ai/agent/users/spez" \
  -H "x-api-key: <token>"

User profile

{
  "id": "string",
  "name": "string",
  "created_utc": 0,
  "link_karma": 0,
  "comment_karma": 0,
  "is_gold": true,
  "icon_img": "string",
  "subreddit": {
    "public_description": "string"
  }
}

Get user posts

Returns recent posts by a Reddit user.

GET
/agent/users/{username}/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

usernameRequiredstring

Reddit username (without u/ prefix)

Query Parameters

limitinteger

Number of items to return (max 100)

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

User's 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 user comments

Returns recent comments by a Reddit user.

GET
/agent/users/{username}/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

usernameRequiredstring

Reddit username (without u/ prefix)

Query Parameters

limitinteger

Number of items to return (max 100)

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

User's 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"
  }
]

Subreddits

Previous Page

CLI Reference

Install and use @reddgrow/cli to query Reddit data from the terminal or shell scripts