ReddGrowReddGrow Docs
API Reference

Subreddits

Subreddit data — info, posts, comments, rules, wiki, and more

Search subreddits

Search for subreddits matching a query string. Returns community metadata.

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

curl -X GET "https://api.reddgrow.ai/agent/subreddits/search?q=typescript+programming" \
  -H "x-api-key: <token>"

List of matching subreddits

[
  {
    "display_name": "typescript",
    "subscribers": 312000,
    "created_utc": 1356998400,
    "public_description": "TypeScript is a language for application-scale JavaScript.",
    "description": "string",
    "submit_text": "string",
    "over18": false,
    "subreddit_type": "public",
    "active_user_count": 847,
    "submission_type": "any",
    "allow_images": true,
    "allow_videos": true,
    "allow_polls": true,
    "allow_galleries": true,
    "restrict_posting": true,
    "link_flair_enabled": true,
    "spoilers_enabled": true
  }
]

Get subreddit info

Returns detailed information about a subreddit — subscribers, description, settings, and more.

GET
/agent/subreddits/{name}/about

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)

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

Subreddit information

{
  "display_name": "typescript",
  "subscribers": 312000,
  "created_utc": 1356998400,
  "public_description": "TypeScript is a language for application-scale JavaScript.",
  "description": "string",
  "submit_text": "string",
  "over18": false,
  "subreddit_type": "public",
  "active_user_count": 847,
  "submission_type": "any",
  "allow_images": true,
  "allow_videos": true,
  "allow_polls": true,
  "allow_galleries": true,
  "restrict_posting": true,
  "link_flair_enabled": true,
  "spoilers_enabled": true
}

Get posting rules

Returns the posting rules for a subreddit. Essential before posting to avoid violations.

GET
/agent/subreddits/{name}/rules

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)

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

Subreddit posting rules

[
  {
    "kind": "all",
    "short_name": "Be respectful",
    "description": "Treat others with respect. No personal attacks, hate speech, or harassment.",
    "violation_reason": "Disrespectful behavior",
    "created_utc": 1548979200,
    "priority": 1
  }
]

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" | "rising" | "controversial"
limitinteger

Number of posts to return (max 100)

Default: 25Minimum: 1Maximum: 100
tstring

Time filter (only applies when sort=top or sort=controversial)

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>"

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

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

List of recent 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"
  }
]

List wiki pages

Returns a list of all wiki page names for a subreddit. Useful for discovering available documentation.

GET
/agent/subreddits/{name}/wiki

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)

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

List of wiki page names

[
  "index",
  "rules",
  "resources",
  "faq"
]

Read a wiki page

Returns the full Markdown content of a specific wiki page. Great for reading community guidelines and resources.

GET
/agent/subreddits/{name}/wiki/{page}

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)

pageRequiredstring

Wiki page name (e.g., "index", "rules", "resources")

curl -X GET "https://api.reddgrow.ai/agent/subreddits/typescript/wiki/index" \
  -H "x-api-key: <token>"

Wiki page content

{
  "kind": "wikipage",
  "data": {
    "content_md": "string",
    "content_html": "string",
    "revision_by": {
      "data": {
        "name": "string"
      }
    },
    "revision_date": 0
  }
}

Get sidebar widgets

Returns the sidebar widgets for a subreddit, including links, text, and community resources.

GET
/agent/subreddits/{name}/widgets

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)

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

Sidebar widgets

[
  {}
]

Get traffic stats

Returns historical traffic statistics for a subreddit (pageviews and unique visitors by day, hour, and month).

GET
/agent/subreddits/{name}/traffic

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)

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

Traffic statistics

{
  "day": [
    [
      1704067200,
      15420,
      8234
    ],
    [
      1703980800,
      12890,
      7123
    ]
  ],
  "hour": [
    [
      0
    ]
  ],
  "month": [
    [
      0
    ]
  ]
}

Check if URL was posted

Checks whether a given URL has already been submitted to a subreddit. Returns existing posts if found. Useful before posting to avoid duplicate submission violations.

GET
/agent/subreddits/{name}/check-url

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

urlRequiredstring

URL to check for duplicate submissions

Format: "uri"
curl -X GET "https://api.reddgrow.ai/agent/subreddits/typescript/check-url?url=https%3A%2F%2Fexample.com%2Fblog%2Ftypescript-tips" \
  -H "x-api-key: <token>"

URL check result

{
  "alreadyPosted": true,
  "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
    }
  ]
}

Posts

Previous Page

Users

Next Page