# Reddit Search Media API (https://www.socialcrawl.dev/platforms/reddit/search-media)

> Searches Reddit's media-scoped index: the posts a keyword search would return, filtered to those that actually carry an image, a video or a gallery. Use it when you want visual content for a topic and do not want to filter a mixed page yourself. Up to 25 posts per page, each with the title, the score, the comment count, the subreddit, the upvote ratio, the flair, the author avatar, the thumbnail and the media at `content.media_urls` — an array on a gallery post and a single-element array otherwise. Reddit's operators work in `query` here too, so `subreddit:name terms` scopes the sweep to one community. `timeframe` applies on `sort=relevance`, `sort=top` and `sort=comment_count`; it has no effect on `sort=new`, which is already newest-first. Paginate with `cursor`. A query that matches nothing still returns loosely-related media posts rather than an empty list, which is Reddit's own search behaviour.

TL;DR: `GET /v1/reddit/search/media` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search phrase. Reddit's operators work here: `subreddit:name terms` scopes the sweep to one community, and quotes force an exact phrase. |
| `sort` | no | Sort by (relevance \| new \| top \| comment_count) |
| `timeframe` | no | Only return posts from this window. Applied on sort=relevance, sort=top and sort=comment_count. It has no effect with sort=new, which is already ordered newest-first. (all \| day \| week \| month \| year) |
| `cursor` | no | Cursor to get more results. Get 'cursor' from the previous response. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/reddit/search/media?query=mechanical%20keyboard%20build" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Reddit API: https://www.socialcrawl.dev/platforms/reddit

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing