RedCrawler API
Users & Profiles V2

Follow / Unfollow Profile V2

Follow or unfollow a Reddit user. Accepts username (raw, u/name, or profile URL) or direct account ID (t2_xxx). Automatically resolves the username to account I

POST /api/v2/profile/follow-action

Follow or unfollow a Reddit user. Accepts username (raw, u/name, or profile URL) or direct account ID (t2_xxx). Automatically resolves the username to account ID before updating. Requires bearer token.

Query parameters

NameTypeRequiredDescription
actionstringYesAction: follow or unfollow
usernamestringNoUsername, u/name, or profile URL. Ignored if account_id provided.
bearerstringNoBearer token — auto-resolves from Token Vault
account_idstringNoReddit t2_ account ID. If provided, skips username lookup.
proxystringNoCustom proxy address (only needed if not using vault)

Authentication

HeaderValue
X-RapidAPI-KeyYour RapidAPI key
X-RapidAPI-Hostred-crawler1.p.rapidapi.com

Example request

cURL

curl -X POST "https://red-crawler1.p.rapidapi.com/api/v2/profile/follow-action?action=follow&username=Motor_Tip8865&bearer=<bearer>&account_id=<account_id>&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/profile/follow-action?action=follow&username=Motor_Tip8865&bearer=<bearer>&account_id=<account_id>&proxy=<proxy>", {
  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/v2/profile/follow-action?action=follow&username=Motor_Tip8865&bearer=<bearer>&account_id=<account_id>&proxy=<proxy>"
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": {
    "success": true,
    "follow_state": {
      "updateProfileFollowState": {
        "ok": true,
        "errors": null
      }
    }
  },
  "error": null,
  "meta": {
    "vault_expires_at": "2026-04-30T07:47:21.906002+00:00",
    "vault_remaining": "13h 51m"
  },
  "timestamp": "2026-04-29T17:55:43.905517+00:00"
}

On this page