Subreddit Research

Before your agent posts to or engages with a subreddit, it should understand the community. This guide walks through a complete research sequence for r/typescript — covering community info, rules, wiki, top content, and URL history.

Total cost for this sequence: 12 credits

Step 1 — Get community info (1 credit)

Start with the about endpoint. It returns subscriber count, activity level, description, and moderation settings.

curl -H "x-api-key: $REDDGROW_API_KEY" \
  https://api.reddgrow.ai/agent/subreddits/typescript/about

reddgrow subreddits about typescript

{
  "name": "typescript",
  "title": "TypeScript",
  "subscribers": 312000,
  "active_user_count": 847,
  "description": "TypeScript is a typed superset of JavaScript...",
  "submit_text": "Please search before posting.",
  "over18": false,
  "allow_polls": false
}

Use subscribers and active_user_count to decide whether the community is worth targeting. Use submit_text to understand any pre-submission guidance.

Step 2 — Read posting rules (1 credit)

Rules tell your agent what content is allowed and what gets removed.

curl -H "x-api-key: $REDDGROW_API_KEY" \
  https://api.reddgrow.ai/agent/subreddits/typescript/rules

reddgrow subreddits rules typescript

{
  "rules": [
    {
      "short_name": "No self-promotion",
      "description": "Blog posts and tutorials must be educational, not promotional.",
      "violation_reason": "Self-promotion"
    },
    {
      "short_name": "Search before posting",
      "description": "Check if your question has been asked before.",
      "violation_reason": "Duplicate"
    }
  ]
}

Parse short_name and description into your agent's context window before it drafts a post or comment.

Step 3 — Read the wiki (5 credits)

The wiki often contains FAQs, resource lists, and community history that isn't captured in the sidebar.

curl -H "x-api-key: $REDDGROW_API_KEY" \
  https://api.reddgrow.ai/agent/subreddits/typescript/wiki/index

reddgrow subreddits wiki typescript index

{
  "content_md": "# r/typescript wiki\n\n## Frequently asked questions\n...",
  "revision_date": 1710000000
}

Wiki pages cost 5 credits each. Only fetch them when your agent needs deep context — for example, before writing a comprehensive tutorial post.

Step 4 — Check top posts (2 credits)

Scan recent top posts to understand what content performs well and what tone the community expects.

curl -H "x-api-key: $REDDGROW_API_KEY" \
  "https://api.reddgrow.ai/agent/subreddits/typescript/posts?sort=top&t=week"

reddgrow subreddits posts typescript --sort top --t week

{
  "posts": [
    {
      "id": "abc123",
      "title": "TypeScript 5.4 released",
      "score": 1842,
      "num_comments": 134,
      "url": "https://devblogs.microsoft.com/typescript/..."
    }
  ]
}

Use the title and score fields to identify patterns. High-scoring posts give your agent a template for framing its own submission.

Step 5 — Check if your URL was already posted (3 credits)

Avoid duplicate submissions by checking whether your URL has already been shared in this subreddit.

curl -H "x-api-key: $REDDGROW_API_KEY" \
  "https://api.reddgrow.ai/agent/subreddits/typescript/check-url?url=https://example.com/article"

reddgrow subreddits check-url typescript --url https://example.com/article

{
  "found": false,
  "posts": []
}

If found is true, the posts array will contain the existing submissions. Your agent can link to the existing thread instead of reposting.

Full sequence summary

To reduce cost, skip the wiki step unless your agent needs deep background. Steps 1, 2, and 5 alone give enough context for most posting decisions at just 5 credits.