{ "openapi": "3.0.1", "info": { "title": "Google Search Results Scraper", "description": "Scrape Google Search for any keyword or URL: organic results, AI Overview, People Also Ask, related searches, ads, videos and knowledge panel. No login or API key. Country, language and date filters. Bulk input, auto proxy fallback. Export JSON, CSV or Excel.", "version": "1.0", "x-build-id": "3C8VKCdxIuiCHDPfQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_minds~google-search-results-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_minds-google-search-results-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/data_minds~google-search-results-scraper/runs": { "post": { "operationId": "runs-sync-data_minds-google-search-results-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/data_minds~google-search-results-scraper/run-sync": { "post": { "operationId": "run-sync-data_minds-google-search-results-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", "required": [ "queries" ], "properties": { "queries": { "title": "🔎 Search terms or Google URLs", "minItems": 1, "type": "array", "description": "One search term or one Google search URL (https://www.google.com/search?q=...) per line. Add as many as you like. Each one returns its own record.", "items": { "type": "string" } }, "maxItems": { "title": "🔢 Max results", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Total number of organic results for the whole run, shared fairly between all searches. 0 means every result Google serves. Free plan users get up to 10 results per run; paid plans have no limit.", "default": 20 }, "maxPagesPerQuery": { "title": "🔢 Max result pages per search", "minimum": 1, "maximum": 3000, "type": "integer", "description": "Upper limit of Google result pages fetched for one search. Google rarely serves more than about 10 pages.", "default": 10 }, "countryCode": { "title": "📍 Country", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "in", "pk", "bd", "lk", "np", "sg", "my", "id", "ph", "th", "vn", "jp", "kr", "cn", "hk", "tw", "ae", "sa", "il", "tr", "eg", "za", "ng", "ke", "ma", "de", "at", "ch", "fr", "be", "nl", "lu", "es", "pt", "it", "gr", "se", "no", "dk", "fi", "is", "pl", "cz", "sk", "hu", "ro", "bg", "hr", "rs", "ua", "ru", "mx", "br", "ar", "cl", "co", "pe", "ve", "ec", "uy" ], "type": "string", "description": "Country the results are localized for.", "default": "us" }, "languageCode": { "title": "🌍 Language", "enum": [ "en", "de", "fr", "es", "it", "pt-br", "pt-pt", "nl", "sv", "no", "da", "fi", "pl", "cs", "sk", "hu", "ro", "bg", "hr", "sr", "uk", "ru", "el", "tr", "he", "ar", "fa", "hi", "bn", "ur", "ta", "te", "mr", "th", "vi", "id", "ms", "fil", "ja", "ko", "zh-cn", "zh-tw", "sw", "af" ], "type": "string", "description": "Interface and result language.", "default": "en" }, "quickDateRange": { "title": "📅 Quick date range", "enum": [ "any", "1h", "24h", "7d", "2w", "1m", "1y" ], "type": "string", "description": "Only results from this period. Choose \"Any time\" to use the After and Before dates below instead.", "default": "any" }, "afterDate": { "title": "📅 After date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only results published on or after this date (YYYY-MM-DD). Used when the quick date range is \"Any time\"." }, "beforeDate": { "title": "📅 Before date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only results published on or before this date (YYYY-MM-DD). Used when the quick date range is \"Any time\"." }, "includeExtraSections": { "title": "✅ Include ads, related searches and answers", "type": "boolean", "description": "Also collect ads, related searches and People Also Ask answers. Adds a few seconds per search. AI Overview, videos and knowledge panel are always included when Google shows them.", "default": true }, "resolveLinks": { "title": "✅ Resolve real result links", "type": "boolean", "description": "Return the final destination URL of every result, sitelink and video rather than an intermediate link.", "default": true }, "expandByDate": { "title": "✅ Widen by date when results run out", "type": "boolean", "description": "Google serves about 65 distinct results per search. When Max results is higher, older date windows are searched to reach it. Only used when no date filter is set.", "default": true }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Starts without a proxy. If Google rejects the request, the Actor switches to a datacenter proxy, then to a residential proxy, and stays on it. Choose Residential here to start on it right away." } } }, "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 } } } } } } } } } }