Load Chat Threads

Load the authenticated user's Reddit chat threads (1:1 DMs + group chats). Returns rooms with name, partner, last message, last sender, last timestamp, unread c

GET /api/v2/inbox/threads

Load the authenticated user's Reddit chat threads (1:1 DMs + group chats). Returns rooms with name, partner, last message, last sender, last timestamp, unread count, and optionally per-room message totals with per-sender breakdown. Set include_counts=true to include per-room message counts and per-sender tallies — useful for dashboards and analytics. Capped at count_limit per room (default 500). Requires bearer token. The proxy stored in your Token Vault must be the same IP your bearer was created on.

Query parameters

Name	Type	Required	Description
`count_limit`	number	No	Max messages to scan per room when counting (1-1000). Higher = more accurate but slower. Default 500.
`bearer`	string	No	Reddit bearer token. Auto-resolves from your stored Token Vault entry.
`include_counts`	boolean	No	Count how many messages each person sent in every chat room. Useful for analytics. Default true.
`proxy`	string	No	Proxy `ip:port:user:pass`. Auto-resolves from your stored Token Vault entry.

Authentication

Header	Value
`X-RapidAPI-Key`	Your RapidAPI key
`X-RapidAPI-Host`	`red-crawler1.p.rapidapi.com`

Example request

cURL

curl -X GET "https://red-crawler1.p.rapidapi.com/api/v2/inbox/threads?count_limit=500&bearer=<bearer>&include_counts=true&proxy=<proxy>" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: red-crawler1.p.rapidapi.com"

JavaScript

const res = await fetch("https://red-crawler1.p.rapidapi.com/api/v2/inbox/threads?count_limit=500&bearer=<bearer>&include_counts=true&proxy=<proxy>", {
  method: "GET",
  headers: {
      "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
    }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://red-crawler1.p.rapidapi.com/api/v2/inbox/threads?count_limit=500&bearer=<bearer>&include_counts=true&proxy=<proxy>"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.get(url, headers=headers)
print(resp.json())

Example response

HTTP 200 — captured from a live call to the gateway.

{
  "success": true,
  "data": {
    "source": "matrix /sync",
    "self": "@t2_29onm7dc32:reddit.com",
    "self_name": "Motor_Tip8865",
    "total_rooms": 0,
    "total_invites": 0,
    "dms": 0,
    "groups": 0,
    "total_unread": 0,
    "timeline_counter": 0,
    "invites_counter": 0,
    "counts_status": "unavailable",
    "threads": [],
    "invites": []
  },
  "error": null,
  "meta": {
    "vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
    "vault_remaining": "22h 46m"
  },
  "timestamp": "2026-04-29T09:00:26.142936+00:00"
}