ReddGrowReddGrow Docs
Reddit Intelligence for AI AgentsAPI Reference

Meta

Account and authentication information

Get account info

Returns your account identity and current credit balance.

GET
/agent/me

Authorization

x-api-key<token>

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

In: header

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

Account info and credit balance

{
  "ok": true,
  "credits": {
    "used": 42,
    "remaining": 958,
    "limit": 1000
  }
}

Get a job

Status and result of an asynchronous read. Free (0 credits). Jobs are scoped to your organization and kept for 24 hours. A job that failed on ReddGrow's side (error.status 503) has its credits refunded automatically; a Reddit 403, 404 or 429 is returned as it happened.

GET
/agent/jobs/{id}

Authorization

x-api-key<token>

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

In: header

Path Parameters

idRequiredstring

The jobId from a 202 response

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

Current state of the job

{
  "jobId": "string",
  "status": "queued",
  "result": [
    {
      "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
    }
  ],
  "creditsCharged": 0,
  "error": {
    "status": 0,
    "message": "string"
  }
}

Domains

Previous Page

Posts

Next Page