Users

User Upvoted

Fetch the posts and comments a Reddit account has UPVOTED. PRIVATE — Reddit only serves this to the account that owns it, so the session cookies must belong to name itself or the call fails with 403. Mixed listing: each item in the response is a post or a comment, tagged with a kind field. Get session cookies from POST /api/reddit/login first. Cost: $0.0015 per call.

get/api/reddit/user/{name}/upvoted

Request

  • Base URL: https://api.redditapis.com
  • URL: https://api.redditapis.com/api/reddit/user/{name}/upvoted
  • Auth: HTTP bearer

Path parameters

namestring required

Reddit username (no u/ prefix) — must match the account the cookies belong to

Query parameters

reddit_sessionstring required

Account session cookie, from POST /api/reddit/login

loidstring required

Account loid cookie, from POST /api/reddit/login

csrf_tokenstring

Account CSRF cookie, from POST /api/reddit/login. Not required for a read; harmless if included.

sortstring

new (default) | top | hot | controversial

tstring

Timeframe for sort=top/controversial: hour | day | week | month | year | all

limitinteger

Number of results to return, 1-100 (default 25)

afterstring

Pagination cursor. Pass back the after value from the previous response exactly as it was sent; it is opaque and carries your paging depth. When after comes back null there is no next page to request, but that does not always mean you have every item: Reddit often stops serving a busy listing long before it runs out, and it also caps any single listing at roughly 1000 items. The response says which happened in listing_status (complete, truncated, or unknown). Only complete means you have everything.

Response

Successful response.

itemsobject[]
afterstring nullable

Opaque pagination cursor; null when no next page is offered.

exhausted_reasonstring nullable

Present only when after is null: why the listing stopped.

listing_statusstring nullable

complete | truncated | unknown. Only complete means you have every item.

items_returnedinteger nullable

Running item count across the pages walked so far.

final_page_itemsinteger nullable

Items on the last page served.

hintstring nullable

Human-readable next step for this exhausted_reason.

Changes

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