Search Reddit Posts

PythonSocial Media

POST api.upapi.io/reddit-search-posts.get

Search Reddit posts by keyword with subreddit filtering, sort and time range. Returns structured post data including scores, comment count and metadata. Requires a Reddit session cookie in sessionCookies (obtain it from reddit-login.post, or copy reddit_session out of a signed-in browser) — Reddit has blocked every anonymous read surface since 2026-07-30.

redditsearchpostssocial

AuthAPI key

Cost4 units

Timeout60s

Cache300s

Request schema

Field	Type	Description
`sort`	string	Sort order: relevance, hot, top, new, comments· default: `"relevance"`
`time`	string	Time filter: hour, day, week, month, year, all· default: `"all"`
`after`		Pagination cursor (fullname of last item)· default: `null`
`limit`	integer	Max results per page· default: `25`
`query`req	string	Search query
`proxyUrl`		User-provided proxy URL· default: `null`
`subreddit`		Limit search to a specific subreddit· default: `null`
`sessionCookies`		REQUIRED IN PRACTICE. Reddit account session cookies, as a JSON object or a '; '-delimited cookie header; the blob must contain reddit_session. Since 2026-07-30 Reddit blocks EVERY anonymous read surface, so a call without cookies returns a classified UPSTREAM_BLOCKED rather than data. Obtain the blob from reddit-login.post, or copy the reddit_session cookie out of a signed-in browser. A lead-gen account-pool row stores it nested at cookies->>'sessionCookies', not at the row's top level.· default: `null`

Response schema

Field	Type	Description
`after`req
`posts`req	array
`query`req	string
`elapsedMs`req	integer
`fetchedAt`req	string
`totalResults`req	integer

Try it

queryrequired

Search query

sortoptional· default: relevance

Sort order: relevance, hot, top, new, comments

timeoptional· default: all

Time filter: hour, day, week, month, year, all

afteroptional· default: null

Pagination cursor (fullname of last item)

limitoptional· default: 25

Max results per page

proxyUrloptional· default: null

User-provided proxy URL

subredditoptional· default: null

Limit search to a specific subreddit

sessionCookiesoptional· default: null

REQUIRED IN PRACTICE. Reddit account session cookies, as a JSON object or a '; '-delimited cookie header; the blob must contain reddit_session. Since 2026-07-30 Reddit blocks EVERY anonymous read surface, so a call without cookies returns a classified UPSTREAM_BLOCKED rather than data. Obtain the blob from reddit-login.post, or copy the reddit_session cookie out of a signed-in browser. A lead-gen account-pool row stores it nested at cookies->>'sessionCookies', not at the row's top level.

Run this endpoint live

Jump in as a guest — no signup — and run reddit-search-posts.get with your own inputs. Create a free account anytime to get your own API key.

Code examples

curl -X POST https://api.upapi.io/reddit-search-posts.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "sort": "relevance", "time": "all", "limit": 25, "query": "typescript" }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.