# Reddit API

> Posts, comments, search and community stats from any public subreddit.

- **Platform:** [Reddit](https://lurkapi.com/docs/reddit.md) (reddit.com)
- **Web page:** https://lurkapi.com/docs/reddit

## Overview

Read Reddit the way people see it on reddit.com: subreddit feeds, full comment threads, site-wide and in-subreddit search, and community stats. Useful for audience research, brand and competitor monitoring, and finding the questions your customers ask. Field names follow Reddit's own API, so code written for Reddit's JSON keeps working; fields reddit.com's pages don't carry are left out rather than faked.

Source: reddit.com.

## Try it live

Pick an endpoint and run it: real data, no signup, 5 free requests a day.

Live playground: https://lurkapi.com/docs/reddit#try

## Endpoints

- [Subreddit posts](https://lurkapi.com/docs/reddit/subreddit-posts.md): A subreddit's feed (hot, new, top, rising or best), with titles, text, scores and comment counts. (GET /v1/reddit/subreddit · 1 credit)
- [Subreddit details](https://lurkapi.com/docs/reddit/subreddit-details.md): A community's size, activity, description, rules and images. (GET /v1/reddit/subreddit/details · 1 credit)
- [Subreddit search](https://lurkapi.com/docs/reddit/subreddit-search.md): Search one subreddit's posts by keyword, returned as compact result cards. (GET /v1/reddit/subreddit/search · 1 credit)
- [Search Reddit](https://lurkapi.com/docs/reddit/search.md): Search all of Reddit for posts matching a keyword. (GET /v1/reddit/search · 1 credit)
- [Post comments](https://lurkapi.com/docs/reddit/post-comments.md): A Reddit post and its comment thread, with nested replies. (GET /v1/reddit/post/comments · 1 credit)

## Call it

Every endpoint is a `GET` with your key in the `x-api-key` header. For example, [Subreddit posts](https://lurkapi.com/docs/reddit/subreddit-posts.md):

curl:

```bash
curl "https://api.lurkapi.com/v1/reddit/subreddit?subreddit=marketing" \
  -H "x-api-key: YOUR_API_KEY"
```

[Get a free API key](https://lurkapi.com/login?next=/dashboard)

## Use it in Claude

Once LurkAPI is [connected to Claude](https://lurkapi.com/docs.md#claude), each endpoint is a tool Claude can call:

| Tool | What it does |
| --- | --- |
| `reddit_subreddit_posts` | [Subreddit posts](https://lurkapi.com/docs/reddit/subreddit-posts.md): A subreddit's feed (hot, new, top, rising or best), with titles, text, scores and comment counts. |
| `reddit_subreddit_details` | [Subreddit details](https://lurkapi.com/docs/reddit/subreddit-details.md): A community's size, activity, description, rules and images. |
| `reddit_subreddit_search` | [Subreddit search](https://lurkapi.com/docs/reddit/subreddit-search.md): Search one subreddit's posts by keyword, returned as compact result cards. |
| `reddit_search` | [Search Reddit](https://lurkapi.com/docs/reddit/search.md): Search all of Reddit for posts matching a keyword. |
| `reddit_post_comments` | [Post comments](https://lurkapi.com/docs/reddit/post-comments.md): A Reddit post and its comment thread, with nested replies. |