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

# JSON

> Read a stream as JSON. Supports whole file and incremental read methods.

Read a stream as JSON. Supports two read methods: whole file (for smaller responses) and incremental (for large files processed line by line).

## Fields

### Read method

* **Whole file** — reads the entire response into memory and then processes it. Supports the "Pattern to items" field.
* **Incremental** — streams through the file without loading it all at once. Supports the "Path to incrementally read over" field instead.

### Pattern to items (whole file only)

Dot-notated path to the array within the JSON response that contains the items to process. Each element in the array becomes a separate entity.

* Leave empty to treat the whole file as a single item.
* Use `data` to read items from `{"data": [...]}`.
* Use `response.products` to read items from `{"response": {"products": [...]}}`.

**Note:** Do not use `*` here — this field points to the array itself, not to individual elements. The system automatically iterates over all elements in the matched array.

### Path to incrementally read over (incremental only)

List of JSON path selectors describing the path to stream over. See the [json-decode-stream docs](https://github.com/klkvsk/json-decode-stream#selectors) for supported selectors.