Store Token

Store your Reddit credentials in the Token Vault. Two modes: • Bearer mode — provide `bearer` + `proxy`. The bearer is stored as-is and expires in ~24h; you mu

POST /api/v1/vault/store

Store your Reddit credentials in the Token Vault. Two modes:

• Bearer mode — provide bearer + proxy. The bearer is stored as-is and expires in ~24h; you must rotate it manually.

• Session mode (recommended) — provide session + proxy. The session is converted to a fresh bearer and kept refreshed automatically until the session itself expires (typically ~6 months). Hand over the session once, forget about token rotation.

Either bearer OR session is required; proxy is always required. The proxy must be the same external IP where the bearer/session was originally created — Reddit binds sessions to their originating IP and will silently return an anonymous bearer if the IP differs.

Fails with 400 if a token already exists for your account — use PUT /api/v1/vault/update to replace it, or DELETE /api/v1/vault/clear to remove it first.

Query parameters

Name	Type	Required	Description
`proxy`	string	Yes	Proxy in host:port:user:pass format. Must match the IP the bearer/session was created on.
`bearer`	string	No	Reddit bearer token (token_v2). Required if `session` is not provided.
`session`	string	No	Reddit `reddit_session` cookie JWT. When provided, enables auto-refresh — a fresh bearer is derived immediately and kept current until the session expires. Takes precedence over `bearer` if both are sent.

Authentication

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

Example request

cURL

curl -X POST "https://red-crawler1.p.rapidapi.com/api/v1/vault/store?proxy=<proxy>&bearer=<bearer>&session=<session>" \
  -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/v1/vault/store?proxy=<proxy>&bearer=<bearer>&session=<session>", {
  method: "POST",
  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/v1/vault/store?proxy=<proxy>&bearer=<bearer>&session=<session>"
headers = {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "red-crawler1.p.rapidapi.com"
}
resp = requests.post(url, headers=headers)
print(resp.json())

Example response

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

{
  "success": true,
  "data": {
    "token_hint": "...ZWvw",
    "expires_at": "2026-04-30T07:47:21.906002+00:00",
    "remaining": "13h 55m",
    "proxy": "126.122.43.123:8888",
    "stored": true
  },
  "error": null,
  "timestamp": "2026-04-29T17:51:54.275302+00:00"
}