{ "openapi": "3.0.1", "info": { "title": "Google Search Scraper ($0.35/1000 results)", "description": "Extract structured Google results across Search, Images, Videos, Places, Maps, News, Shopping, Scholar, Autocomplete, and Patents. Supports query/category batching, localization, pagination, retries, and clean dataset output.", "version": "0.0", "x-build-id": "GBZQdAwcFvafMYqdt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-ninja~google-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-ninja-google-search-scraper", "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/api-ninja~google-search-scraper/runs": { "post": { "operationId": "runs-sync-api-ninja-google-search-scraper", "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/api-ninja~google-search-scraper/run-sync": { "post": { "operationId": "run-sync-api-ninja-google-search-scraper", "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": { "queries": { "title": "🔍 Search queries", "type": "array", "description": "List of Google search queries. Each query is searched separately, with the result limit applied per query. Search operators are supported, for example: adele site:youtube.com. Requests are limited to one per second, including pagination and retries. Takes precedence over the legacy single query field.", "items": { "type": "string", "minLength": 1 }, "default": [] }, "query": { "title": "Single search query (legacy)", "minLength": 1, "type": "string", "description": "Optional single query for compatibility with existing inputs. Used only when the Search queries list is empty." }, "maxResults": { "title": "🔢 Maximum results", "minimum": 10, "maximum": 10000, "type": "integer", "description": "Maximum number of organic search results to store per query. The final API page is trimmed so each query does not exceed this number. Ignored when Parse all available results is enabled.", "default": 100 }, "parseAllResults": { "title": "Parse all available results", "type": "boolean", "description": "For each query, keep following provider pagination until no organic results or no next-page cursor remains.", "default": false }, "includeRelatedKeywords": { "title": "Include related keywords", "type": "boolean", "description": "Also store related keyword and spelling suggestion records in the dataset. Disabled by default so the dataset contains only organic search results.", "default": false }, "country": { "title": "🌎 Country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "ISO 3166-1 alpha-2 country code. The provider automatically derives gl and proxy_location unless you override them below.", "default": "US" }, "gl": { "title": "📍 Google country (gl)", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter country code used to localize Google results, for example US, GB, or DE." }, "hl": { "title": "🗣️ Google UI language (hl)", "pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$", "type": "string", "description": "Google interface language, for example en, fr, de, zh-CN, or zh-TW.", "default": "en" }, "tbs": { "title": "🗓️ Time filter (tbs)", "type": "string", "description": "Google time filter, such as qdr:h, qdr:d, qdr:w, qdr:m, qdr:y, or a custom cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY range." }, "lr": { "title": "🌐 Language restriction (lr)", "pattern": "^lang_[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$", "type": "string", "description": "Restrict result language, for example lang_en, lang_fr, or lang_zh-CN." }, "cr": { "title": "🚩 Country restriction (cr)", "pattern": "^country[A-Za-z]{2}$", "type": "string", "description": "Restrict results to a country, for example countryUS or countryGB." }, "proxy_location": { "title": "🛰️ Provider proxy region", "enum": [ "us", "ca" ], "type": "string", "description": "Explicit provider proxy region. Only US and Canada are supported." } } }, "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 } } } } } } } } } }