Reoogle API Reference

Authorization: Bearer rog_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Verify your key with a minimal request
curl https://reoogle.com/api/v1/me/usage \
  -H "Authorization: Bearer rog_live_xxxxxxxxxx"

# Expected 200 response:
# { "key_name": "Production", "limits": { ... }, "recent_requests": [...] }

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1750000000   # Unix timestamp when the 60s window resets
X-RateLimit-Daily-Limit: 1000
X-RateLimit-Daily-Remaining: 952

0
async function fetchWithBackoff(url, options, retries = 4) {
  const res = await fetch(url, options);

  if (res.status === 429 && retries > 0) {
    const retryAfter = Number(res.headers.get(1) ?? 1);
    const jitter     = Math.random() * 500; 2
    await new Promise((r) => setTimeout(r, retryAfter * 1000 + jitter));
    return fetchWithBackoff(url, options, retries - 1);
  }

  if (!res.ok) {
    const err = await res.json().catch(() => ({}));
    throw new Error(err?.error?.message ?? 3);
  }

  return res;
}

// All error responses follow this shape
{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit of 60 requests/minute exceeded. Retry after 12 seconds."
  }
}

// Successful responses never include an "error" key
{
  "data": [ ... ],
  "pagination": { ... }
}

# Active English subs where you can drop links — sorted by most active
curl "https://reoogle.com/api/v1/subreddits?inactive_mods=true&allows_links=true&link_posts_survive=true&lang=en&min_posts_60d=5&sort_by=activity&per_page=10" \
  -H "Authorization: Bearer rog_live_..."

{
  "data": [
    {
      "id": "664f9a4a-...",
      "name": "Pacific_Islanders",
      "member_count": 440,
      "title": "Pacific Islanders",
      "icon_img": "https://styles.redditmedia.com/...",
      "over18": false,
      "subreddit_type": "public",
      "restrict_posting": false,
      "allows_links": true,
      "link_posts_survive": true,
      "posts_last_60d": 18,
      "avg_comments": 4.2,
      "unique_posters_60d": 11,
      "inactive_mods": true,
      "last_checked": "2026-06-25T08:00:00Z",
      "activity_checked_at": "2026-06-25T08:01:12Z"
    }
  ],
  "pagination": { "page": 1, "per_page": 10, "total": 3820, "total_pages": 382 }
}

curl "https://reoogle.com/api/v1/subreddits/Pacific_Islanders" \
  -H "Authorization: Bearer rog_live_..."

{
  "id": "664f9a4a-...",
  "name": "Pacific_Islanders",
  "member_count": 440,
  "restrict_posting": false,
  "allows_links": true,
  "link_posts_survive": true,
  "posts_last_60d": 18,
  "avg_comments": 4.2,
  "moderators": [
    {
      "username": "AutoModerator",
      "reddit_user_id": "t2_6l4z3",
      "mod_since": 1483228800,
      "mod_permissions": ["all"],
      "last_checked": "2026-06-25T08:01:12Z"
    }
  ]
}

{
  "subreddit": "Pacific_Islanders",
  "activity": [
    { "day_of_week": "monday", "utc_hour": 17, "posts": 4, "comments": 12, "engagement": 41, "last_updated": "2026-06-23T00:00:00Z" }
  ]
}

# Top 20 active English subs — ready to post in
curl "https://reoogle.com/api/v1/subreddits/postable?lang=en&min_posts_60d=3&sort_by=activity&per_page=20" \
  -H "Authorization: Bearer rog_live_..."

import requests

resp = requests.get(
    0,
    params={1: 2, 3: 3, 4: 5, 6: 20},
    headers={7: 8},
)
for sub in resp.json()[9]:
    print(f10)

{
  "data": [ ... ],
  "pagination": { "page": 1, "per_page": 20, "total": 1240, "total_pages": 62 },
  "filters_applied": {
    "inactive_mods": true,
    "restrict_posting": false,
    "link_posts_survive": "true_or_unknown"
  }
}

curl "https://reoogle.com/api/v1/subreddits/Pacific_Islanders/moderators" \
  -H "Authorization: Bearer rog_live_..."

{
  "subreddit": "Pacific_Islanders",
  "count": 2,
  "moderators": [
    {
      "username": "AutoModerator",
      "reddit_user_id": "t2_6l4z3",
      "mod_since": 1483228800,
      "mod_permissions": ["all"],
      "last_checked": "2026-06-25T08:01:12Z"
    },
    {
      "username": "some_inactive_user",
      "reddit_user_id": "t2_abc123",
      "mod_since": 1514764800,
      "mod_permissions": ["posts", "flair"],
      "last_checked": "2026-06-25T08:01:12Z"
    }
  ]
}

{
  "data": [
    { "category": "Gaming",      "count": 1820 },
    { "category": "Technology",  "count": 1340 },
    { "category": "General",     "count": 9180 }
  ]
}

{
  "key_name": "Production",
  "limits": {
    "per_minute": { "limit": 60, "used": 3, "resets_at": "2026-06-24T12:01:00Z" },
    "per_day":    { "limit": 1000, "used": 48, "resets_at": "2026-06-25T00:00:00Z" }
  },
  "recent_requests": [
    {
      "timestamp": "2026-06-24T11:59:43Z",
      "method": "GET",
      "path": "/api/v1/subreddits",
      "status": 200,
      "duration_ms": 34
    }
  ]
}

POST <your-endpoint-url>
Content-Type: application/json
X-Reoogle-Signature: <hmac-sha256-hex>
X-Reoogle-Event: mods.inactive
X-Reoogle-Delivery: a1b2c3d4-...

{
  "event": "mods.inactive",
  "timestamp": "2026-06-23T16:00:00Z",
  "data": {
    "subreddit": "Pacific_Islanders",
    "member_count": 440
  }
}

import crypto from 0;

function verifySignature(rawBody: Buffer, signature: string, secret: string): boolean {
  const expected = crypto
    .createHmac(1, secret)
    .update(rawBody)
    .digest(2);

  3
  return crypto.timingSafeEqual(
    Buffer.from(signature, 4),
    Buffer.from(expected, 5)
  );
}

6
app.post(
  7,
  express.raw({ type: 8 }),
  (req, res) => {
    const sig = req.header(9) ?? 10;

    if (!verifySignature(req.body, sig, process.env.REOOGLE_WEBHOOK_SECRET!)) {
      return res.status(401).json({ error: 11 });
    }

    const event = JSON.parse(req.body.toString());
    console.log(12, event.event, event.data);
    res.sendStatus(200);
  }
);

curl https://reoogle.com/api/v1/ai-posts \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "data": [
    {
      "id": "uuid",
      "subreddit_name": "SaaS",
      "title": "Six months of cold outreach and the only thing that moved the needle was...",
      "body": "...",
      "post_type": "text",
      "status": "posted",
      "reddit_post_id": "t3_abc123",
      "reddit_post_url": "https://www.reddit.com/r/SaaS/comments/abc123/...",
      "score": 42,
      "upvote_ratio": 0.91,
      "comment_count": 7,
      "view_count": 1204,
      "posted_at": "2026-06-25T10:00:00Z",
      "last_checked_at": "2026-06-25T12:00:00Z"
    }
  ],
  "stats": {
    "total": 14,
    "posted": 11,
    "pending": 1,
    "failed": 1,
    "removed": 1,
    "avg_score": 18,
    "best_score": 42,
    "total_comments": 39
  },
  "page": 1,
  "per_page": 20,
  "total": 14
}

curl https://reoogle.com/api/v1/ai-posts/POST_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "post": { "id": "uuid", "title": "...", "status": "posted" }
}

curl -X PATCH https://reoogle.com/api/v1/ai-posts/POST_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body": "Updated body content here."}'

{
  "post": { "id": "uuid", "body": "Updated body content here." },
  "reddit_synced": true,
  "reddit_error": null
}

curl -X DELETE https://reoogle.com/api/v1/ai-posts/POST_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "success": true,
  "reddit_deleted": true
}

curl -X PUT https://reoogle.com/api/v1/ai-posts/POST_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Better title", "subreddit_name": "SaaS"}'

{
  "post": { "id": "uuid", "title": "Better title", "status": "pending_review" },
  "reddit_synced": false
}

curl -X POST https://reoogle.com/api/v1/ai-posts/POST_UUID/approve \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "ok": true,
  "post": {
    "id": "uuid",
    "status": "posted",
    "reddit_post_id": "t3_abc123",
    "reddit_post_url": "https://www.reddit.com/r/SaaS/comments/abc123/..."
  }
}

curl -X POST https://reoogle.com/api/v1/ai-posts/POST_UUID/reject \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{ "ok": true }

curl -X POST https://reoogle.com/api/v1/schedule \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -F "title=Check out our new dashboard" \
  -F "subreddit=indiehackers" \
  -F "scheduled_for=2026-07-10T14:00:00Z" \
  -F "image=@/path/to/screenshot.png"

// 201 Created
{
  "post": {
    "id": "uuid",
    "title": "Check out our new dashboard",
    "subreddit_name": "indiehackers",
    "scheduled_for": "2026-07-10T14:00:00.000Z",
    "status": "scheduled",
    "post_type": "link",
    "image_url": "https://reoogle.com/api/v1/images/uid_1751234567.png"
  }
}

# Step 1 — upload once
curl -X POST https://reoogle.com/api/v1/uploads \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -F "file=@screenshot.png"
# → { "url": "https://reoogle.com/api/v1/images/uid_1751234567.png" }

# Step 2 — reuse the URL in multiple schedule requests
curl -X POST https://reoogle.com/api/v1/schedule \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Check out our new dashboard",
    "subreddit": "indiehackers",
    "scheduled_for": "2026-07-10T14:00:00Z",
    "image_url": "https://reoogle.com/api/v1/images/uid_1751234567.png"
  }'

curl https://reoogle.com/api/v1/schedule \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "data": [
    {
      "id": "uuid",
      "title": "How I automated my Reddit presence without spamming",
      "body": "After 6 months of trial and error I found the approach that works…",
      "subreddit_name": "indiehackers",
      "scheduled_for": "2026-07-10T14:00:00.000Z",
      "status": "scheduled",
      "post_type": "text",
      "image_url": null,
      "created_at": "2026-07-04T09:00:00.000Z"
    }
  ],
  "page": 1,
  "per_page": 20,
  "total": 3
}

curl -X POST https://reoogle.com/api/v1/schedule \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "How I automated my Reddit presence without spamming",
    "body": "After 6 months of trial and error I found the approach that works…",
    "subreddit": "indiehackers",
    "scheduled_for": "2026-07-10T14:00:00Z"
  }'

// 201 Created
{
  "post": {
    "id": "uuid",
    "title": "How I automated my Reddit presence without spamming",
    "body": "After 6 months of trial and error I found the approach that works…",
    "subreddit_name": "indiehackers",
    "scheduled_for": "2026-07-10T14:00:00.000Z",
    "status": "scheduled",
    "post_type": "text",
    "image_url": null,
    "created_at": "2026-07-04T09:00:00.000Z"
  }
}

curl https://reoogle.com/api/v1/schedule/POST_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "post": { "id": "uuid", "title": "…", "scheduled_for": "2026-07-10T14:00:00.000Z", "status": "scheduled" }
}

# Reschedule to a different time
curl -X PATCH https://reoogle.com/api/v1/schedule/POST_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scheduled_for": "2026-07-11T09:00:00Z" }'

# Change title and subreddit at the same time
curl -X PATCH https://reoogle.com/api/v1/schedule/POST_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Better headline", "subreddit": "SaaSneeded" }'

{
  "post": {
    "id": "uuid",
    "title": "Better headline",
    "subreddit_name": "SaaSneeded",
    "scheduled_for": "2026-07-11T09:00:00.000Z",
    "status": "scheduled"
  }
}

curl -X DELETE https://reoogle.com/api/v1/schedule/POST_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "success": true,
  "cancelled_id": "uuid"
}

curl "https://reoogle.com/api/v1/subreddits/unmoderated?limit=10" \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "subreddits": [
    {
      "id": "uuid",
      "name": "DigitalNomadHub",
      "member_count": 12400,
      "title": "Digital Nomad Hub",
      "icon_img": "https://...",
      "over18": false,
      "posts_last_60d": 8,
      "avg_comments": 3.2,
      "allows_links": true,
      "link_posts_survive": true
    }
  ],
  "total": 341,
  "page": 1,
  "limit": 10
}

curl "https://reoogle.com/api/v1/reddit/inbox?unread=true" \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "messages": [
    {
      "id": 1,
      "message_type": "comment_reply",
      "author": "redditor123",
      "subject": "re: My post title",
      "body": "Great post! How did you...",
      "subreddit": "SaaS",
      "reddit_link": "https://reddit.com/r/SaaS/comments/...",
      "is_read": false,
      "created_utc": 1751400000
    }
  ],
  "total": 4
}

# Mark specific messages
curl -X PATCH https://reoogle.com/api/v1/reddit/inbox \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": [1, 2, 3]}'

# Mark all as read
curl -X PATCH https://reoogle.com/api/v1/reddit/inbox \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mark_all": true}'

{ "ok": true }

curl -X DELETE https://reoogle.com/api/v1/reddit/inbox \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": [1, 2, 3]}'

{ "ok": true, "deleted": 3 }

curl https://reoogle.com/api/v1/competitors \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "competitors": [
    {
      "id": "uuid",
      "name": "CompetitorBrand",
      "domain": "competitor.com",
      "created_at": "2026-06-01T10:00:00Z"
    }
  ]
}

curl -X POST https://reoogle.com/api/v1/competitors \
  -H "Authorization: Bearer rog_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "CompetitorBrand", "domain": "competitor.com"}'

{
  "competitor": {
    "id": "uuid",
    "name": "CompetitorBrand",
    "domain": "competitor.com",
    "created_at": "2026-07-02T10:00:00Z"
  }
}

curl -X DELETE https://reoogle.com/api/v1/competitors/COMPETITOR_UUID \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{ "ok": true }

curl "https://reoogle.com/api/v1/competitors/COMPETITOR_UUID/mentions?limit=10" \
  -H "Authorization: Bearer rog_live_YOUR_KEY"

{
  "competitor": { "id": "uuid", "name": "CompetitorBrand" },
  "mentions": [
    {
      "id": "uuid",
      "reddit_post_id": "t3_xyz",
      "post_title": "Which tool is better — CompetitorBrand or alternatives?",
      "post_url": "https://reddit.com/r/SaaS/comments/xyz/...",
      "subreddit": "SaaS",
      "author": "some_redditor",
      "body_snippet": "I tried CompetitorBrand last month and...",
      "score": 14,
      "found_at": "2026-07-01T08:00:00Z"
    }
  ],
  "total": 23
}

app.post(0, express.raw({ type: 1 }), async (req, res) => {
  if (!verifySignature(req.body, req.header(2) ?? 3, SECRET)) {
    return res.sendStatus(401);
  }

  const { event, data } = JSON.parse(req.body.toString());

  if (event === 4) {
    await fetch(process.env.SLACK_WEBHOOK_URL!, {
      method: 5,
      headers: { 6: 7 },
      body: JSON.stringify({
        text: 8,
      }),
    });
  }

  res.sendStatus(200);
});

import requests

API    = 0
HEADERS = {1: 2}
WATCHLIST = [3, 4]

for name in WATCHLIST:
    resp = requests.get(f5, headers=HEADERS)
    resp.raise_for_status()

    total = sum(row[6] for row in resp.json()[7])
    baseline = load_baseline(name)  8

    if baseline and total < baseline * 0.8:
        send_email(f9)

    save_baseline(name, total)

const API     = 0;
const HEADERS = { Authorization: 1 };

async function findPostableSubreddits(opts = {}) {
  const params = new URLSearchParams({
    lang:          2,
    min_posts_60d: 3,     4
    min_members:   5,
    sort_by:       6,
    per_page:      7,
    ...opts,
  });

  const res  = await fetch(8, { headers: HEADERS });
  const body = await res.json();

  return body.data.map((s: any) => ({
    name:               s.name,
    members:            s.member_count,
    posts_per_60d:      s.posts_last_60d,
    avg_comments:       s.avg_comments,
    restrict_posting:   s.restrict_posting,   9
    link_posts_survive: s.link_posts_survive,
    icon:               s.icon_img,
  }));
}

10
const targets = await findPostableSubreddits();
console.table(targets.slice(0, 10));

const API = 0;
const HEADERS = { Authorization: 1 };

async function topSubreddits(category: string, limit = 10) {
  const url = new URL(2);
  url.searchParams.set(3, category);
  url.searchParams.set(4, 5);
  url.searchParams.set(6, 7);
  url.searchParams.set(8, String(limit));

  const res = await fetch(url.toString(), { headers: HEADERS });
  if (!res.ok) throw new Error(9);

  const { data } = await res.json();
  return data.map((s: any) => ({ name: s.name, members: s.member_count }));
}

10
const gaming = await topSubreddits(11);
console.table(gaming);