ReddGrowReddGrow Docs
API v1Reference

Managed

Managed CRUD operations

API health check

GET
/v1/health

Authorization

x-api-key<token>

In: header

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

API is healthy

List drafts

GET
/v1/drafts

Authorization

x-api-key<token>

In: header

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

Paginated list of drafts with status counts

Get a draft by ID

GET
/v1/drafts/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Draft ID

curl -X GET "https://api.reddgrow.ai/v1/drafts/{id}" \
  -H "x-api-key: <token>"

Draft details

Approve a draft for posting

POST
/v1/drafts/{id}/approve

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Draft ID

curl -X POST "https://api.reddgrow.ai/v1/drafts/{id}/approve" \
  -H "x-api-key: <token>"

Draft approved

Skip a draft

POST
/v1/drafts/{id}/skip

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Draft ID

curl -X POST "https://api.reddgrow.ai/v1/drafts/{id}/skip" \
  -H "x-api-key: <token>"

Draft skipped

List campaigns

GET
/v1/campaigns

Authorization

x-api-key<token>

In: header

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

Paginated list of campaigns

Create campaign

POST
/v1/campaigns

Authorization

x-api-key<token>

In: header

curl -X POST "https://api.reddgrow.ai/v1/campaigns" \
  -H "x-api-key: <token>"

Campaign created

Get campaign by ID

GET
/v1/campaigns/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Campaign ID

curl -X GET "https://api.reddgrow.ai/v1/campaigns/{id}" \
  -H "x-api-key: <token>"

Campaign details

Update campaign

PATCH
/v1/campaigns/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Campaign ID

curl -X PATCH "https://api.reddgrow.ai/v1/campaigns/{id}" \
  -H "x-api-key: <token>"

Campaign updated

Delete campaign

DELETE
/v1/campaigns/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Campaign ID

curl -X DELETE "https://api.reddgrow.ai/v1/campaigns/{id}" \
  -H "x-api-key: <token>"

Campaign deleted

List subreddits

GET
/v1/subreddits

Authorization

x-api-key<token>

In: header

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

Paginated list of subreddits

Create subreddit

POST
/v1/subreddits

Authorization

x-api-key<token>

In: header

curl -X POST "https://api.reddgrow.ai/v1/subreddits" \
  -H "x-api-key: <token>"

Subreddit created

Quick-add a subreddit by name, fetching metadata from Reddit

POST
/v1/subreddits/quick-add

Authorization

x-api-key<token>

In: header

curl -X POST "https://api.reddgrow.ai/v1/subreddits/quick-add" \
  -H "x-api-key: <token>"

Subreddit quick-added

Get subreddit by ID

GET
/v1/subreddits/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Subreddit ID

curl -X GET "https://api.reddgrow.ai/v1/subreddits/{id}" \
  -H "x-api-key: <token>"

Subreddit details

Update subreddit

PATCH
/v1/subreddits/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Subreddit ID

curl -X PATCH "https://api.reddgrow.ai/v1/subreddits/{id}" \
  -H "x-api-key: <token>"

Subreddit updated

Delete subreddit

DELETE
/v1/subreddits/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Subreddit ID

curl -X DELETE "https://api.reddgrow.ai/v1/subreddits/{id}" \
  -H "x-api-key: <token>"

Subreddit deleted

Toggle active state of a subreddit

PATCH
/v1/subreddits/{id}/active

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Subreddit ID

curl -X PATCH "https://api.reddgrow.ai/v1/subreddits/{id}/active" \
  -H "x-api-key: <token>"

Active state updated

List advocates

GET
/v1/advocates

Authorization

x-api-key<token>

In: header

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

Paginated list of advocates

Create advocate

POST
/v1/advocates

Authorization

x-api-key<token>

In: header

curl -X POST "https://api.reddgrow.ai/v1/advocates" \
  -H "x-api-key: <token>"

Advocate created

Get advocate by ID

GET
/v1/advocates/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Advocate ID

curl -X GET "https://api.reddgrow.ai/v1/advocates/{id}" \
  -H "x-api-key: <token>"

Advocate details

Update advocate

PATCH
/v1/advocates/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Advocate ID

curl -X PATCH "https://api.reddgrow.ai/v1/advocates/{id}" \
  -H "x-api-key: <token>"

Advocate updated

Delete advocate

DELETE
/v1/advocates/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Advocate ID

curl -X DELETE "https://api.reddgrow.ai/v1/advocates/{id}" \
  -H "x-api-key: <token>"

Advocate deleted

List monitored domains

GET
/v1/brand-monitor/domains

Authorization

x-api-key<token>

In: header

curl -X GET "https://api.reddgrow.ai/v1/brand-monitor/domains" \
  -H "x-api-key: <token>"

Paginated list of monitored domains

Add a domain to monitor

POST
/v1/brand-monitor/domains

Authorization

x-api-key<token>

In: header

curl -X POST "https://api.reddgrow.ai/v1/brand-monitor/domains" \
  -H "x-api-key: <token>"

Domain created

Get a monitored domain by ID

GET
/v1/brand-monitor/domains/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Domain ID

curl -X GET "https://api.reddgrow.ai/v1/brand-monitor/domains/{id}" \
  -H "x-api-key: <token>"

Domain details

Update a monitored domain

PATCH
/v1/brand-monitor/domains/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Domain ID

curl -X PATCH "https://api.reddgrow.ai/v1/brand-monitor/domains/{id}" \
  -H "x-api-key: <token>"

Domain updated

Delete a monitored domain

DELETE
/v1/brand-monitor/domains/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Domain ID

curl -X DELETE "https://api.reddgrow.ai/v1/brand-monitor/domains/{id}" \
  -H "x-api-key: <token>"

Domain deleted

List brand mentions

GET
/v1/brand-monitor/mentions

Authorization

x-api-key<token>

In: header

curl -X GET "https://api.reddgrow.ai/v1/brand-monitor/mentions" \
  -H "x-api-key: <token>"

Paginated list of mentions

Get a single brand mention

GET
/v1/brand-monitor/mentions/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Mention ID

curl -X GET "https://api.reddgrow.ai/v1/brand-monitor/mentions/{id}" \
  -H "x-api-key: <token>"

Mention details

Update a brand mention status or sentiment

PATCH
/v1/brand-monitor/mentions/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idRequiredunknown

Mention ID

curl -X PATCH "https://api.reddgrow.ai/v1/brand-monitor/mentions/{id}" \
  -H "x-api-key: <token>"

Mention updated

Get brand mention stats summary

GET
/v1/brand-monitor/stats

Authorization

x-api-key<token>

In: header

curl -X GET "https://api.reddgrow.ai/v1/brand-monitor/stats" \
  -H "x-api-key: <token>"

Stats summary

Dashboard summary — campaigns, draft counts, posting stats

GET
/v1/stats/summary

Authorization

x-api-key<token>

In: header

curl -X GET "https://api.reddgrow.ai/v1/stats/summary" \
  -H "x-api-key: <token>"

Dashboard summary

Daily draft stats (org-scoped)

Returns a day-by-day series of draft counts, posted counts and health metrics.

GET
/v1/stats/drafts/daily

Authorization

x-api-key<token>

In: header

curl -X GET "https://api.reddgrow.ai/v1/stats/drafts/daily" \
  -H "x-api-key: <token>"

Daily draft time series

Draft dashboard counts

GET
/v1/stats/drafts/dashboard

Authorization

x-api-key<token>

In: header

curl -X GET "https://api.reddgrow.ai/v1/stats/drafts/dashboard" \
  -H "x-api-key: <token>"

Draft dashboard stats

Posting stats

Returns posts today, last posted time, cooldown, and daily limit.

GET
/v1/stats/posting

Authorization

x-api-key<token>

In: header

curl -X GET "https://api.reddgrow.ai/v1/stats/posting" \
  -H "x-api-key: <token>"

Posting stats