Load Inbox Feed

Fetch the authenticated user's Reddit inbox notification feed — replies, mentions, mod actions, achievements, and chat invites. Returns paginated items with tit

GET /api/v2/inbox/feed

Fetch the authenticated user's Reddit inbox notification feed — replies, mentions, mod actions, achievements, and chat invites. Returns paginated items with title, body, deeplink URL, sent/read timestamps, and a read-state flag. 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
`include_announcement`	boolean	No	Include announcement items in the feed. Default true.
`page_size`	number	No	Total items to return (1-500). Auto-paginates if over 100. Default 20.
`bearer`	string	No	Reddit bearer token (token_v2 JWT). Optional — auto-resolves from your stored Token Vault entry.
`proxy`	string	No	Proxy in `ip:port:user:pass` format. Optional — 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/feed?include_announcement=true&page_size=20&bearer=<bearer>&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/feed?include_announcement=true&page_size=20&bearer=<bearer>&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/feed?include_announcement=true&page_size=20&bearer=<bearer>&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": {
    "items": [
      {
        "id": "ann_b07v6o",
        "title": "",
        "body": "",
        "deeplink_url": "",
        "sent_at": "2026-04-29T08:16:44.830526+0000",
        "read_at": "",
        "is_read": false
      }
    ],
    "count": 1,
    "cursor": "fFJFQUNIRURfRU5EfE1UYzNOelExTURZd05EZ3pNQQ=="
  },
  "error": null,
  "meta": {
    "vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
    "vault_remaining": "22h 46m"
  },
  "timestamp": "2026-04-29T09:00:23.734295+00:00"
}