> ## 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 Posts

> Get recent posts from a subreddit with engagement metrics

## Parameters

<ParamField query="subreddit" type="string" required>
  Subreddit name (e.g., `AskReddit`)
</ParamField>

<ParamField query="sort" type="string">
  Sort by Available options: `hot`, `new`, `top`, `rising`
</ParamField>

<ParamField query="after" type="string">
  Pagination token. Get 'after' from previous response.
</ParamField>

## Example Request

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

## Example Response

```json theme={null}
{
  "success": true,
  "data": {
    "posts": [
      {
        "subreddit": "AskReddit",
        "title": "What are your thoughts on...",
        "subreddit_name_prefixed": "r/AskReddit",
        "ups": 12606,
        "upvote_ratio": 0.93,
        "score": 12606,
        "num_comments": 5678,
        "name": "t3_1ldr6b9"
      }
      // ... more posts
    ]
  },
  "meta": {
    "platform": "reddit",
    "endpoint": "subreddit",
    "request_id": "req_abc123"
  }
}
```

> Response data is returned directly from the Yoinkit API.