{ "openapi": "3.0.1", "info": { "title": "SPSS, Stata & SAS to CSV, JSON & Parquet (keeps labels)", "description": "Convert SPSS .sav/.zsav, Stata .dta and SAS .sas7bdat/.xpt files to CSV, JSON or Parquet — preserving the value labels, variable labels and metadata that naive exports drop.", "version": "0.0", "x-build-id": "q3ejHcNL73u3KesVA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nibble~statistical-file-to-csv/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nibble-statistical-file-to-csv", "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/nibble~statistical-file-to-csv/runs": { "post": { "operationId": "runs-sync-nibble-statistical-file-to-csv", "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/nibble~statistical-file-to-csv/run-sync": { "post": { "operationId": "run-sync-nibble-statistical-file-to-csv", "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", "properties": { "fileUrls": { "title": "File URLs", "type": "array", "description": "Public URLs of statistical files to convert (.sav, .zsav, .dta, .xpt, .sas7bdat, .por). Each is downloaded with retries. The format is detected from the file extension.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keyValueStoreKeys": { "title": "Key-value store keys (uploaded files)", "type": "array", "description": "Keys in this run's default key-value store that hold statistical-file bytes. This is how files uploaded via the Console form are passed to the Actor. Name each key with its file extension (e.g. survey.sav) so the format can be detected, or set the Format override below.", "items": { "type": "string" } }, "filesBase64": { "title": "Inline files (base64)", "type": "array", "description": "Files sent inline as {\"filename\": \"survey.sav\", \"data\": \"\"} — convenient for API or AI-agent callers. The filename's extension selects the reader." }, "outputFormat": { "title": "Output format", "enum": [ "csv", "json", "parquet" ], "type": "string", "description": "Downloadable file format saved to the key-value store for each converted file. CSV and Parquet are the flattened table; JSON keeps the full structured record (rows + labels + metadata). The dataset always contains the structured JSON regardless.", "default": "csv" }, "applyValueLabels": { "title": "Apply value labels to data", "type": "boolean", "description": "Replace coded values with their human-readable value labels in the rows (e.g. 1 -> \"Male\"). Off keeps the raw codes and returns the code -> label maps separately (best for pipelines). Only affects SPSS/Stata files that carry inline value labels.", "default": false }, "keepUserMissing": { "title": "Keep user-defined missing values", "type": "boolean", "description": "Keep user-defined missing values (e.g. 99 = 'no answer') as their coded value instead of collapsing them to null. The missing-value ranges are always reported in the output metadata either way.", "default": false }, "maxRows": { "title": "Max rows per file", "minimum": 0, "type": "integer", "description": "Cap the number of data rows converted per file (0 or blank = no cap)." }, "format": { "title": "Format override", "enum": [ "sav", "zsav", "dta", "xpt", "sas7bdat", "por" ], "type": "string", "description": "Force the input format when a URL or key-value-store key has no recognizable extension. Leave blank to auto-detect from the filename." } } }, "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 } } }, "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 } } } } } } } } } }