> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.yoinkit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Subreddit Search

> Search within a subreddit for posts, comments, or media matching a query

## Parameters

<ParamField query="subreddit" type="string" required>
  Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)
</ParamField>

<ParamField query="query" type="string">
  Search query to find matching content (e.g., `push ups`)
</ParamField>

<ParamField query="filter" type="string">
  Type of content to search for (default: posts). Response will only include the matching key (e.g. filter=posts returns only 'posts', not 'comments' or 'media')
</ParamField>

## Example Request

```bash theme={null}
curl -X GET "https://yoinkit.ai/api/v1/openclaw/reddit/subreddit/search?subreddit=EXAMPLE" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

## Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "posts": [
      {
        "id": "t3_8gmjrb",
        "title": "Is doing 50-100 pushups a day doing anything?",
        "url": "https://www.reddit.com/r/Fitness/comments/8gmjrb/...",
        "subreddit": { "id": "t5_2qhx4", "name": "Fitness" }
      }
      // ... more posts
    ]
  },
  "meta": {
    "platform": "reddit",
    "endpoint": "subreddit-search",
    "request_id": "req_abc123"
  }
}
```

> Response data is returned directly from the Yoinkit API.