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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List posts

> List ranked posts from one subreddit.

<Warning>
  Reddit connections are temporarily unavailable while Automate.ax awaits
  Reddit's approval for commercial Data API access. You can connect a Reddit
  account after the integration is approved and enabled.
</Warning>

`reddit.listPosts` list ranked posts from one subreddit.

```ts automations/reddit-list-posts.automation.ts theme={null}
import { automation } from "automate.ax"
import { reddit } from "automate.ax/reddit"

export default automation("List posts", () => {
  const result = reddit.listPosts({
    subreddit: "AutomateAx",
    sort: "new",
    limit: 25,
  })
})
```

## Inputs

Set `subreddit`. `sort` defaults to `new`; use `hot`, `rising`, `top`, or `controversial`. `limit` defaults to 25 and is capped at 100. Pass `after` from the prior page; `time` applies to `top` and `controversial`. Compatible signals are accepted. Use the optional second argument `{ account }` to select a named Reddit binding.

## Output

Returns `posts` and `pageInfo`. Post fullnames begin with `t3_`; timestamps are `Date` values.