{ "openapi": "3.0.1", "info": { "title": "XLSX & CSV to JSON Converter", "description": "Convert spreadsheet files (XLSX, XLSM, XLS, CSV, TSV) to clean JSON rows by URL or upload. All sheets or chosen ones, header detection, real dates and numbers, encoding and delimiter auto-detection.", "version": "0.0", "x-build-id": "5tjNVD6xDtQUkmIZR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ridgeline_apps~spreadsheet-converter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ridgeline_apps-spreadsheet-converter", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ridgeline_apps~spreadsheet-converter/runs": { "post": { "operationId": "runs-sync-ridgeline_apps-spreadsheet-converter", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ridgeline_apps~spreadsheet-converter/run-sync": { "post": { "operationId": "run-sync-ridgeline_apps-spreadsheet-converter", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "files" ], "properties": { "files": { "title": "Spreadsheet files", "type": "array", "description": "Paste file URLs (one per line) or upload files. Supports .xlsx, .xlsm, .xls, .csv and .tsv." }, "sheets": { "title": "Sheets to convert", "type": "array", "description": "Sheet names to convert in XLSX and XLS files (not case-sensitive). Leave empty to convert every sheet.", "items": { "type": "string" } }, "headerRow": { "title": "Header row", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Row number that holds the column names. Rows above it are skipped. Use 0 if there is no header row; columns are then named column_1, column_2 and so on.", "default": 1 }, "skipEmptyRows": { "title": "Skip empty rows", "type": "boolean", "description": "Leave out rows with no values.", "default": true }, "trimWhitespace": { "title": "Trim whitespace", "type": "boolean", "description": "Remove spaces at the start and end of text cells. Cells that become empty are set to null.", "default": true }, "inferCsvTypes": { "title": "Detect numbers and true/false in CSV", "type": "boolean", "description": "Turn CSV text like 42, 3.5 and true into real numbers and booleans. Values with leading zeros, such as ZIP codes, stay as text. Cells in XLSX and XLS files always keep their own types.", "default": true }, "csvDelimiter": { "title": "CSV delimiter", "enum": [ "auto", "comma", "semicolon", "tab", "pipe" ], "type": "string", "description": "Auto-detect works for most files.", "default": "auto" }, "maxRowsPerSheet": { "title": "Max rows per sheet", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Safety limit on rows converted from each sheet.", "default": 100000 }, "maxFileSizeMb": { "title": "Max file size (MB)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Larger files are skipped and not charged.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }