RedditAPIRedditAPIs
Profile

Set a Reddit Profile Display Name (Not Username)

Set the display name on a Reddit profile — the human-readable name shown above the username. Up to 90 characters. The username itself is not changed.

POST/api/reddit/profile/display-name$0.012 / call

Set the profile's display name — the human-readable name shown above the username. Does not change the username itself. Up to 90 characters.

Request Body

Cookies are passed as flat top-level fields.

FieldTypeRequiredDescription
display_namestringyesNew display name, ≤ 90 chars
reddit_sessionstringyesSession cookie from /api/reddit/login
csrf_tokenstringyesAnti-CSRF cookie
loidstringnoAccount loid cookie (recommended)
proxyobject | stringnoSticky IP for this account. { server, username?, password? } or "http://user:pass@host:port"
max_attemptsnumbernoRetry budget (default 3)

Example

curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
    "display_name": "Em",
    "reddit_session": "eyJhbGc...",
    "loid": "000000...",
    "csrf_token": "689ea9..."
  }' \
  "https://api.redditapis.com/api/reddit/profile/display-name"
const response = await fetch("https://api.redditapis.com/api/reddit/profile/display-name", {
  method: "POST",
  headers: {
    Authorization: "Bearer TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    display_name: "Em",
    reddit_session: "eyJhbGc...",
    loid: "000000...",
    csrf_token: "689ea9...",
  }),
});
const data = await response.json();
import requests

response = requests.post(
"https://api.redditapis.com/api/reddit/profile/display-name",
json={
"display_name": "Em",
"reddit_session": "eyJhbGc...",
"loid": "000000...",
"csrf_token": "689ea9...",
},
headers={"Authorization": "Bearer TOKEN"},
)
data = response.json()

Success Response

{
  "success": true,
  "username": "your_reddit_username",
  "subreddit_id": "t5_xxxxxxxx",
  "display_name": "Em"
}

Errors

StatusMeaning
400Missing display_name, display_name > 90 chars, or required cookies missing
401Missing Bearer token
403Invalid Bearer token
502Upstream rejected (cookies expired, account flagged)
500Unexpected server error

On this page