reddit

Reddit Media Search

Find Reddit image, video and gallery posts by keyword. Returns posts with a media object holding direct image or video URLs. Costs 2 credits per page. Tip: set kind=image, video or gallery to narrow results; the body field is empty for media results. Costs 2 credits.

get/v1/reddit/media/search

Request

  • Base URL: https://chatterapi.com
  • URL: https://chatterapi.com/v1/reddit/media/search
  • Auth: HTTP bearer

Query parameters

qstring required

Search text. Reddit operators allowed.

kind'image' | 'video' | 'gallery' | 'all'

Media type to return.

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

Result order.

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

Time window.

boolean
OR
string

Include adult media. true needs the 18+ setting.

limitinteger

Max rows to return (1-100). Reddit pages hold about 25 rows; larger values still return one page.

cursorstring

Opaque cursor from the previous response's page.nextCursor.

Response

Success

requestIdstring required
cachedboolean required

Example response

{
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V"
}

Changes

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