Auth

Reddit API Login

Log in with a Reddit username + password (and TOTP secret for 2FA accounts) to obtain the session cookies used by the write, vote, profile, and DM endpoints. Cost: $0.012 per call.

post/api/reddit/login

Request

  • Base URL: https://api.redditapis.com
  • URL: https://api.redditapis.com/api/reddit/login
  • Auth: HTTP bearer

Request body

usernamestring required

Reddit username or email

passwordstring required

Account password

totp_secretstring

Base32 TOTP secret for accounts with 2FA enabled. Omit if 2FA is off.

methodstring

http (default) | browser. Use browser for the most compatible write-session cookies.

localestring

BCP-47 tag for the browser context, e.g. de-DE. Match it to the proxy's country. Default en-US. Applies to the browser context: with method=browser always, and with the default method=http only if that login falls back to a browser (which it does when Reddit blocks the http transport before the login form).

timezonestring

IANA zone for the browser context, e.g. Europe/Berlin. Match it to the proxy's country, or the account acts from your proxy's IP while reporting a New York clock. Casing and aliases are normalised (utc to UTC, europe/berlin to Europe/Berlin, GMT to UTC, Japan to Asia/Tokyo). A numeric offset such as +05:30 is not a timezone and is rejected. Default America/New_York. Applies to the browser context: with method=browser always, and with the default method=http only if that login falls back to a browser (which it does when Reddit blocks the http transport before the login form).

Response

Successful response.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.