{ "openapi": "3.0.1", "info": { "title": "Google Search Scraper", "description": "Fastest real-time Google Search scraper! Extract organic results, AI Overviews (SGE), community answers, and snippets. Supports city-level localization, time filters, and mobile/desktop emulation. Perfect for SEO tracking and SERP analysis.", "version": "1.0", "x-build-id": "Zvy70ZlKdffTAqopC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burbn~google-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burbn-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/burbn~google-search-scraper/runs": { "post": { "operationId": "runs-sync-burbn-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/burbn~google-search-scraper/run-sync": { "post": { "operationId": "run-sync-burbn-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", "required": [ "q" ], "properties": { "q": { "title": "🔎 Search Query", "minLength": 1, "maxLength": 500, "type": "string", "description": "Enter your Google search query. This is the same text you would type into the Google search bar (e.g., 'best programming languages 2025' or 'how to build a website')." }, "start": { "title": "📄 Start Position", "minimum": 0, "maximum": 100, "type": "integer", "description": "The starting position of the results (0-indexed). Use 0 for the first page, 10 for the second page, 20 for the third, etc.", "default": 0 }, "num": { "title": "🔢 Number of Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of search results to return per request (1-100). Note: Every 10 results consumes 1 request credit.", "default": 10 }, "gl": { "title": "🌍 Country Code", "minLength": 2, "maxLength": 2, "type": "string", "description": "Two-letter ISO 3166-1 alpha-2 country code to localize search results (e.g., 'us' for United States, 'gb' for UK, 'de' for Germany, 'in' for India). This affects which country-specific results appear.", "default": "us" }, "hl": { "title": "🗣️ Interface Language", "minLength": 2, "maxLength": 5, "type": "string", "description": "Two-letter ISO 639-1 language code for the search interface and results (e.g., 'en' for English, 'de' for German, 'es' for Spanish, 'fr' for French).", "default": "en" }, "location": { "title": "📍 Location (City Level)", "type": "string", "description": "Specify the origin location for search results at city level (e.g., 'London, England, United Kingdom' or 'New York, New York, United States'). This gives more precise local results than country code alone." }, "lr": { "title": "🌐 Language Restrict", "type": "string", "description": "Restrict results to pages written in specific languages. Use format 'lang_xx' with pipe separator for multiple (e.g., 'lang_fr' for French only, or 'lang_fr|lang_de' for French and German)." }, "tbs": { "title": "⏱️ Time-Based Search (Advanced)", "type": "string", "description": "Advanced search parameters for time-based filtering. Examples: 'qdr:h' (past hour), 'qdr:d' (past day), 'qdr:w' (past week), 'qdr:m' (past month), 'qdr:y' (past year)." }, "nfpr": { "title": "🚫 Disable Auto-Correction", "enum": [ "0", "1" ], "type": "string", "description": "Set to '1' to disable Google's automatic spelling correction and search exactly for the query as entered.", "default": "0" }, "device": { "title": "📱 Device Type", "enum": [ "desktop", "mobile" ], "type": "string", "description": "Choose which device type to emulate for the search. Mobile results may differ from desktop results.", "default": "desktop" }, "fetchAiOverviews": { "title": "🤖 Fetch AI Overviews", "type": "boolean", "description": "Enable to include Google's AI-generated overview/summary in the search results when available.", "default": false }, "returnVideoThumbnail": { "title": "🎬 Return Video Thumbnails", "type": "boolean", "description": "Enable to return base64 encoded image source for video result thumbnails.", "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 } } }, "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 } } } } } } } } } }