Reddit
Post

Search posts

Search posts from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.

get/v1/reddit/search/posts

Request

  • Base URL: https://api.openhandle.dev
  • URL: https://api.openhandle.dev/v1/reddit/search/posts
  • Auth: HTTP bearer

Query parameters

qstring required

Public search query.

sort'relevance' | 'hot' | 'top' | 'new' | 'comments'

Result ordering for this operation.

subredditstring

Search inside one subreddit only.

t'hour' | 'day' | 'week' | 'month' | 'year' | 'all'

Time window for top and controversial results.

limitinteger

Maximum number of results to return.

freshness'live' | '24h' | '7d' | '30d'

Maximum accepted data age. The default is 24h.

cursorstring

Opaque cursor returned by the previous page.

Response

A successful Test or Live response.

capturedAtstring date-time required
platform'instagram' | 'tiktok' | 'twitter' | 'reddit' required
resource'profile' | 'post' | 'comment' | 'hashtag' | 'location' | 'music' | 'category' | 'list' | 'entity' | 'story' | 'highlight' | 'subreddit' | 'rule' | 'wiki' | 'trophy' required
source'live' | 'cache' required

Changes

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