{"uid":"cap_1EI_fWR-U68ECe51yCEAZ","slug":"tanod-docs-xlsx-to-json-97a56384","name":"Tanod Docs XLSX to JSON","description":"Documents: DOCX template fill, Office to PDF, any file to Markdown, PDF to Word, OCR, PDF pipeline.","url":"https://docs.tanod.dev/v1/docs/xlsx-to-json?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"anyOf":[{"type":"string","maxLength":2048,"minLength":1},{"type":"null"}],"default":null,"description":"Public http(s) URL of the workbook (at most 20 MB; private, internal and IP-literal hosts are refused); or use file_base64."},"format":{"enum":["json","csv"],"type":"string","default":"json","description":"json (default: each sheet with its name and rows, cells as strings) or csv (one formula-safe CSV file per sheet)."},"output":{"enum":["base64","url"],"type":"string","default":"base64","description":"base64 (default): the file comes back inline as base64. url: the file is stored for 24 hours and the reply carries a download link (url, expires_at, bytes, content_type, sha256) instead of the base64, which keeps the file out of your context window."},"file_base64":{"anyOf":[{"type":"string","maxLength":13398872,"minLength":1},{"type":"null"}],"default":null,"description":"The workbook as base64 (at most 10 MB decoded; .xlsx or .xlsm); or use url."}}},"responseSchema":{"type":"json","example":{"note":"Cells are strings exactly as the workbook stores them; a formula cell is the value last computed by a spreadsheet application (empty if the file was never opened in one). Trailing empty cells and rows are dropped. CSV output is one file per sheet, UTF-8 with CRLF, and a cell that could be read as a formula is prefixed with an apostrophe (OWASP) so a spreadsheet cannot run it.","format":"json","sheets":[{"name":"Sales","rows":[["region","q1","q2","total"],["North","1204","1311","2515"],["South","980","1015","1995"]],"columns":4,"row_count":3,"truncated":false},{"name":"Notes","rows":[["prepared","2026-10-09"]],"columns":2,"row_count":1,"truncated":false}],"operation":"xlsx-to-json","input_bytes":5425,"sheet_count":2,"sheets_read":2,"untrusted_content":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QcMn967xCni06B5Ct3Fkc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts an Excel workbook (.xlsx/.xlsm) to structured JSON or CSV, returning sheet names, rows, and cell values","exampleAgentPrompt":"Convert this Excel workbook to JSON for me — grab it from https://example.com/report.xlsx and return all sheets with their rows as structured data in json format.","exampleUseCases":[{"title":"Pipeline ingestion from uploaded spreadsheet","prompt":"I have a sales report as a base64-encoded xlsx file — can you parse it into JSON so I can load the rows from each sheet into our database?"},{"title":"Financial data extraction for analysis","prompt":"Fetch this quarterly workbook from https://finance.example.com/Q3-2024.xlsx and convert it to JSON so I can see all the sheets and their row values."},{"title":"Export spreadsheet as CSV for downstream tools","prompt":"Convert this Excel file at https://data.example.com/inventory.xlsx to CSV format and give me a download URL I can pass to our reporting tool."}],"resultDescription":"Returns a JSON object with the output format, operation name, input byte size, sheet count, and an array of sheets — each containing the sheet name, a rows array of string arrays, column count, row count, and a truncated flag. Optionally returns a download URL with expiry, byte size, content type, and SHA-256 hash instead of inline base64 content.","failureModes":["File exceeds 20 MB (URL) or 10 MB (base64) size limit — request rejected","Private, internal, or IP-literal host URLs refused","Unsupported file format (non-.xlsx/.xlsm) — parse error","Formula cells return empty string if file was never opened in a spreadsheet application","Network timeout fetching remote URL","Malformed base64 input — decoding error"],"whenToPreferThis":"Choose this endpoint when you need to extract structured row/cell data from Excel workbooks (.xlsx or .xlsm) as JSON or CSV, especially in automated pipelines where you want per-sheet arrays of string values. Prefer it over generic document converters when the output must preserve multi-sheet structure and cell-level granularity. The URL delivery option is useful when large workbooks would bloat your context window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:45:35.465Z","isFirstParty":false,"canonicalSlug":"tanod-docs-xlsx-to-json-97a56384"}