Purpose
Use Structured Export as the primary output block for custom scrapers that need spreadsheets: product cards, search results, reviews, tables, listings, or directories.
How it works
- Finds all elements matching the row selector.
- For each row, evaluates every column selector relative to that row.
- Extracts text, HTML, common attributes, data attributes, or JavaScript-derived values.
- Writes a CSV file using create or append mode.
- Returns structured data in the run result for inspection.
Configuration fields
| Field | Required | Default | Description |
|---|---|---|---|
| Output File Name | No | exported-data.csv | CSV filename to write. |
| File Mode | No | create | create overwrites the file; append adds rows to an existing file. |
| Save Location | No | - | Folder where the CSV should be written. |
| Row Selector | Yes | - | Selector for each repeated item or table row. |
| Include Headers | No | true | Whether to write column names as the first row. |
| Columns | Yes | - | Each column has a name, a selector relative to the row, and an attribute such as text, html, href, src, value, title, alt, data-*, or JS. |
Output
CSV file and structured rows in the run result.
Usage notes
- Set Row Selector to the repeated card, result, table row, or review wrapper.
- Inside columns, use short relative selectors like h2, a, img, .price, or [data-testid='rating'].
- Use append mode when Navigate loops over multiple URLs into the same CSV.
- If a column selector is empty, UScraper extracts from the row element itself.
- Use JS mode only when normal text or attribute extraction cannot calculate the value.