{ "openapi": "3.0.1", "info": { "title": "Google Sheets Import & Export (No OAuth, Reliable)", "description": "Append, replace, upsert or read Google Sheets from any dataset. No Google sign-in to expire: just share the sheet. Chunked writes with retries, automatic new columns and clear error messages.", "version": "0.1", "x-build-id": "pwkqQHIl5mfdYikGG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stubborn_otter~google-sheets-import-export/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stubborn_otter-google-sheets-import-export", "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/stubborn_otter~google-sheets-import-export/runs": { "post": { "operationId": "runs-sync-stubborn_otter-google-sheets-import-export", "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/stubborn_otter~google-sheets-import-export/run-sync": { "post": { "operationId": "run-sync-stubborn_otter-google-sheets-import-export", "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": [ "spreadsheet" ], "properties": { "spreadsheet": { "title": "Google Sheet link", "type": "string", "description": "Paste your sheet's address from the browser (any Google Sheets link or ID works). The example link is our demo sheet: replace it with yours. Before the first run, click Share in your sheet and add this Actor's service account email (shown in the README) as Editor." }, "mode": { "title": "What to do", "enum": [ "append", "replace", "upsert", "read" ], "type": "string", "description": "Append adds rows after the existing data. Replace clears the tab first. Upsert updates rows whose key column(s) match and appends the rest. Read exports the tab to this run's dataset.", "default": "append" }, "sheetName": { "title": "Tab name", "type": "string", "description": "Which tab to use. Created automatically if it doesn't exist. Leave empty for the tab in your link (or the first tab)." }, "datasetId": { "title": "Dataset to write", "type": "string", "description": "Pick the Apify dataset whose items become rows. In an integration (running after another Actor), set this to {{resource.defaultDatasetId}}." }, "data": { "title": "...or paste rows as JSON", "type": "array", "description": "A list of objects, one per row. Nested fields become columns like 'price.value'." }, "keyColumns": { "title": "Key column(s) for upsert", "type": "array", "description": "Columns that identify a row, e.g. 'url' or 'id'. Only used in upsert mode.", "items": { "type": "string" } }, "insertAt": { "title": "Where to append", "enum": [ "bottom", "top" ], "type": "string", "description": "Append below the existing rows (default) or at the top, right under the header row. Only used in append mode.", "default": "bottom" }, "columns": { "title": "Only these columns (optional)", "type": "array", "description": "Limit and order the columns written. Leave empty to write every field.", "items": { "type": "string" } }, "valueInputOption": { "title": "Treat values as", "enum": [ "RAW", "USER_ENTERED" ], "type": "string", "description": "Plain values (default) write text exactly as given, so scraped text starting with '=' can't run as a formula. 'As if typed' lets Google interpret formulas, dates and numbers.", "default": "RAW" }, "serviceAccountKey": { "title": "Your own service account key (optional)", "type": "string", "description": "Advanced: paste a Google Cloud service account JSON key to use your own account instead of ours. Share the sheet with that account's email." }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Check everything and report what would change, without writing.", "default": false } } }, "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 } } } } } } } } } }