{ "openapi": "3.0.1", "info": { "title": "Google Search Results (SERP) Scraper", "description": "Scrape Google search results for any keyword. Extracts organic rankings (position, URL, title, description, sitelinks), featured snippets, People Also Ask, related searches, knowledge panel, and top ads. Supports web, news, images, and video search. Filter by language, country, and date range.", "version": "0.1", "x-build-id": "mGCAtc39IHQOd00H2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rupom888~google-serp-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rupom888-google-serp-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/rupom888~google-serp-scraper/runs": { "post": { "operationId": "runs-sync-rupom888-google-serp-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/rupom888~google-serp-scraper/run-sync": { "post": { "operationId": "run-sync-rupom888-google-serp-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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Search keywords to look up on Google. Each keyword runs as a separate search.", "items": { "type": "string" } }, "resultsPerKeyword": { "title": "Results Per Keyword", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of organic search results to extract per keyword (up to 100).", "default": 10 }, "searchType": { "title": "Search Type", "enum": [ "web", "news", "images", "videos" ], "type": "string", "description": "Type of Google search to perform.", "default": "web" }, "country": { "title": "Country", "type": "string", "description": "Country code for localized results (e.g. 'us', 'uk', 'ca', 'au', 'de').", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "ISO 639-1 language code to filter results (e.g. 'en', 'es', 'fr'). Leave blank for all languages." }, "dateRange": { "title": "Date Range", "enum": [ "", "day", "week", "month", "year" ], "type": "string", "description": "Filter results by recency.", "default": "" }, "siteFilter": { "title": "Site Filter", "type": "string", "description": "Restrict results to a specific domain (e.g. 'reddit.com'). Adds 'site:' operator to keyword." }, "extractAiOverview": { "title": "Extract AI Overview", "type": "boolean", "description": "Extract Google's AI-generated summary (AI Overview) if present, including the full text and cited sources.", "default": true }, "extractShoppingResults": { "title": "Extract Shopping Results", "type": "boolean", "description": "Extract shopping carousel results (product name, price, store, rating) when present.", "default": true }, "extractVideoResults": { "title": "Extract Video Results", "type": "boolean", "description": "Extract video carousel results (title, channel, duration, thumbnail, URL) when present.", "default": true }, "extractLocalPack": { "title": "Extract Local Pack (Map 3-pack)", "type": "boolean", "description": "Extract Google Maps local pack results (name, address, rating, phone) when present.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxy recommended for Google SERP scraping at scale." } } }, "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 } } } } } } } } } }