> ## 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 dataset items

> Reads one page of structured items from an Apify dataset.

`apify.listDatasetItems` reads one page of structured items from an Apify dataset.

## Example

```ts automations/apify-list-dataset-items.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { apify } from "automate.ax/apify"

export default automation("List dataset items", () => {
  onHttpRequest({ scope: "automation" })

  apify.listDatasetItems({
    datasetId: "dataset-id",
    clean: true,
    limit: 100,
  })
})
```

## Inputs

| Field                     | Type                 | Description                              |
| ------------------------- | -------------------- | ---------------------------------------- |
| `datasetId`               | `string`             | Required dataset ID or name.             |
| `limit`, `offset`         | `number`             | Page size and starting offset.           |
| `desc`                    | `boolean`            | Reverse item order.                      |
| `clean`                   | `boolean`            | Apply Apify's clean-item transformation. |
| `fields`, `omit`          | `string[]`           | Select or omit fields.                   |
| `flatten`, `unwind`       | `string[] \| string` | Transform nested values.                 |
| `skipEmpty`, `skipHidden` | `boolean`            | Exclude empty or hidden fields.          |
| `view`                    | `string`             | Use a saved dataset view.                |

## Output

Returns JSON-object `items` plus `count`, `total`, `limit`, `offset`, and `desc` pagination metadata.

This action exposes structured JSON items. Use Apify storage exports directly when you need CSV, XML, or another download format.