xtract.bot
POST /api/excel-to-csv

Convert an Excel sheet to CSV. Pick a specific sheet by name or index. Cell values are stringified; formulas are evaluated to their cached result.

Reads an Excel workbook (.xlsx or legacy .xls) and returns one sheet as CSV. Options: - `sheet`: pick a sheet by 0-based index (`0`, `1`, …) or by name (`Summary`, `Data`). Default is the first sheet. - `delimiter`: output separator (default `,`; pass `\t` for TSV). Cell values are stringified using their displayed format; formulas are evaluated to their cached result (Excel saves this when the file is closed).

Inputs

NameTypeDefaultDescription
workbook*fileExcel workbook bytes (XLSX, XLSB, XLS, or ODS).
sheetstringSheet name (case-sensitive) or 1-indexed sheet number as a string. Defaults to the first sheet.
delimiterstring","Field delimiter (default `,`).
rawValuesbooleanfalseWhen true, return raw cell values; when false (default), dates are formatted as ISO strings.

Response

Modes: json. Cache: yes (24h TTL).

Code samples

Built from the first-sheet example.

# Download or substitute the example input:
#   curl -O https://xtract.bot/examples/excel-to-csv/sample.xlsx
WORKBOOK=$(base64 -w0 < sample.xlsx)

curl -X POST https://api.xtract.bot/api/excel-to-csv \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Account-Id: $XTRACT_ACCOUNT_ID" \
  -H "X-Api-Key: $XTRACT_API_KEY" \
  -d '{
  "workbook": "'"$WORKBOOK"'"
}'