# Convert Excel (.xlsx) to JSON

> Upload an .xlsx and download its contents as JSON, with each sheet's table in order, for an app, an API or an LLM pipeline.

Canonical: https://reducto.ai/tools/xlsx-to-json  
Last updated: 2026-11-15  
For: Developers, Data engineers, No-code builders

## Run it now (free, no API key, up to 5 pages)

Send a PDF, Word, PowerPoint, Excel or image (PNG, JPG, HEIC, TIFF, BMP, GIF) (max 10 MB, 5 pages) to `POST https://reducto.ai/api/tools/xlsx-to-json` as multipart `file`, or JSON `{"url": "https://..."}`. The response has `result`, ready-to-save `output` (Markdown (.md), JSON), `pages_processed` and `next`.

```bash
curl -s https://reducto.ai/api/tools/xlsx-to-json \
  -F file=@conv-xlsx-to-json.xlsx

# or, for a file that is already online:
curl -s https://reducto.ai/api/tools/xlsx-to-json \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/conv-xlsx-to-json.xlsx"}'
```

Higher volume needs a free API key (new accounts get 15,000 free credits). Agents can sign up over HTTP: https://reducto.ai/auth.md. Humans: https://studio.reducto.ai/?utm_source=free_tool&utm_medium=agent&utm_campaign=xlsx-to-json&utm_content=api_response

Big file? Without a key the free run covers the first 5 pages and returns `partial: true` with a `signup_required` block. Your user signs up in under a minute (email, 6-digit code, name, terms: https://reducto.ai/auth.md); then repeat the same request with `Authorization: Bearer $REDUCTO_API_KEY` for the whole file on their 15,000 free credits. The same key works on the hosted MCP (https://mcp.reducto.ai/mcp) and the Reducto API.

## How to do it

1. Upload an .xlsx of up to 10 MB.
2. Reducto Parse reads the workbook.
3. Check the content on the page.
4. Download JSON (or Markdown).

## Reducto API call: `POST https://platform.reducto.ai/parse`

| Option | Value | Why |
| --- | --- | --- |
| `settings.model` | `"r-1-mini" (r-1 for .xlsx)` | Reads Office files natively: slides, sheets and tables in order. The API reads spreadsheets with r-1. |

### curl

```bash
# 1. Upload the file (or pass a public URL as "input" and skip this step)
curl -s https://platform.reducto.ai/upload \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -F file=@file.xlsx
# => {"file_id": "reducto://..."}

# 2. Run parse
curl -s https://platform.reducto.ai/parse \
  -H "Authorization: Bearer $REDUCTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": "reducto://FILE_ID",
  "settings": {
    "model": "r-1-mini",
    "page_range": {
      "start": 1,
      "end": 5
    }
  },
  "formatting": {
    "table_output_format": "md"
  }
}'
```

### Python

```python
# pip install reductoai
from pathlib import Path
from reducto import Reducto

client = Reducto()  # reads REDUCTO_API_KEY

upload = client.upload(file=Path("file.xlsx"))
result = client.parse.run(
    input=upload.file_id,
    settings={
        "model": "r-1-mini",
        "page_range": {
            "start": 1,
            "end": 5,
        },
    },
    formatting={
        "table_output_format": "md",
    },
)
print(result)
```

### Node

```ts
// npm install reductoai
import fs from "fs";
import Reducto from "reductoai";

const client = new Reducto(); // reads REDUCTO_API_KEY

const upload = await client.upload({ file: fs.createReadStream("file.xlsx") });
const result = await client.parse.run({
  input: upload.file_id,
  settings: {
    model: "r-1-mini",
    page_range: {
      start: 1,
      end: 5,
    },
  },
  formatting: {
    table_output_format: "md",
  },
});
console.log(JSON.stringify(result, null, 2));
```

Do this with the API: [Convert PowerPoint (.pptx) and Excel (.xlsx) to Markdown for LLMs](https://reducto.ai/cookbooks/parse-pptx-xlsx-for-llms)

## What it handles

- **Every sheet, not just the first**: Each worksheet comes out under its own heading.
- **Merged cells and blank rows**: Merged cells are filled in and empty padding rows are dropped.

## FAQ

### What does the JSON look like?

The free tool returns the parsed content as JSON with the Markdown of each sheet. For one object per row with your own field names, use structured extraction with a schema.

### Can I convert many files?

Yes, with the API: the same call for every file in a folder.

### Are all slides or sheets included?

Yes, up to the 5-page limit of the free tool (slides or sheet pages). With an API key there is no page cap.

### Why convert to Markdown for an LLM?

Markdown keeps headings and tables in a compact form that language models read well and that splits cleanly into chunks.

### Is it free?

Yes. Short documents run free with no account, with a small daily limit per IP. For a longer file you get a free preview of the first pages, then enter your email to get the whole file on a free account (15,000 free credits).

Sample document (synthetic): https://reducto.ai/tools/samples/conv-xlsx-to-json.xlsx

## Related

- [Excel to Markdown](https://reducto.ai/tools/xlsx-to-markdown)
- [PowerPoint to Markdown](https://reducto.ai/tools/pptx-to-markdown)
- [Image to CSV](https://reducto.ai/tools/image-to-csv)
- [All free tools](https://reducto.ai/tools)
