{ "openapi": "3.0.1", "info": { "title": "Public Google Sheet to JSON - Read Any Shared Sheet, No Login", "description": "Paste the link of any publicly shared Google Sheet and get one typed JSON row per sheet row: numbers, booleans, ISO dates, clean column keys. Optional tab and SQL-like query. Read-only and public-only: no login, no OAuth, no API key, and private sheets are never touched.", "version": "1.0", "x-build-id": "ac1t88LRQQOMBoFxu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/appdata-labs~public-google-sheet-reader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-appdata-labs-public-google-sheet-reader", "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/appdata-labs~public-google-sheet-reader/runs": { "post": { "operationId": "runs-sync-appdata-labs-public-google-sheet-reader", "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/appdata-labs~public-google-sheet-reader/run-sync": { "post": { "operationId": "run-sync-appdata-labs-public-google-sheet-reader", "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": { "sheets": { "title": "Google Sheets", "type": "array", "description": "Sheets to read: the full link you copy from the browser, with or without #gid=, or a bare sheet ID. A link with #gid= reads that tab. Each entry is judged alone, so a bad one is skipped with its reason and the others still run. The sheet must be shared as 'Anyone with the link can view'.", "default": [ "https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit" ], "items": { "type": "string" } }, "sheetName": { "title": "Tab name", "type": "string", "description": "Optional. The name on the tab at the bottom of the sheet, exactly as written; it applies to every sheet in the list and beats a #gid= in a link. Leave empty for the tab in the link, or the first tab. Google serves the first tab when a name does not exist, so the run warns if the data is identical to the first tab.", "default": "" }, "query": { "title": "Query", "type": "string", "description": "Optional. A Google Visualization API Query Language query, to pick columns or filter rows before they reach you. Use column letters, not header names, and single quotes around text, for example: select A, E where E = 'Art'. Leave empty for every row.", "default": "" }, "maxRows": { "title": "Max rows", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Return at most this many rows in the whole run, across all sheets. Up to 50000. You pay per row returned, so keep this low until you know the size of the sheet.", "default": 100 }, "firstRowIsHeader": { "title": "First row is the header", "type": "boolean", "description": "On: the sheet's first row names the columns, so a column called Home State becomes the key home_state, and that row is not returned as data. Off: every row is data and the keys are column_A, column_B and so on.", "default": true } } }, "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 } } } } } } } } } }