{ "openapi": "3.0.1", "info": { "title": "Local Services Ads & Google Verified Scraper", "description": "The Local Services Ads & Google Verified Scraper extracts businesses from Google local searches — Local Services Ads, Google Verified badges, local pack rankings, ratings, reviews, phones, and websites — ideal for local SEO agencies, lead gen, and competitor tracking.", "version": "0.0", "x-build-id": "hchJy1gnLUui2UHpl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~local-services-ads-google-verified-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-local-services-ads-google-verified-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/piotrv1001~local-services-ads-google-verified-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-local-services-ads-google-verified-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/piotrv1001~local-services-ads-google-verified-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-local-services-ads-google-verified-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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Queries in the form \" in \", e.g. \"plumbers in Austin\", \"roof repair in Chicago, IL\", \"personal injury lawyer in Miami\". The service is matched to one of Google's 111 Local Services categories (you can also write the slug itself, e.g. \"bankruptcy_lawyer in Austin\"); the city is resolved to Google's location id. Local Services Ads exist in the US only.", "default": [ "plumbers in Austin" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Fallback city for queries that do not name one (\"plumbers\" + \"Austin, TX\"). Ignored when the query already says \"in \"." }, "language": { "title": "Language", "type": "string", "description": "Google interface language for the local-pack search (e.g. \"en\", \"de\", \"pl\"). Local Services Ads are always read in en-US.", "default": "en" }, "countryCode": { "title": "Country", "type": "string", "description": "Google country code for the local-pack search (e.g. \"us\", \"gb\", \"pl\"). Local Services Ads are US only.", "default": "us" }, "device": { "title": "Device", "enum": [ "desktop", "mobile" ], "type": "string", "description": "Kept for compatibility and recorded on each row; the HTTP version reads the same data for both profiles.", "default": "desktop" }, "maxResultsPerQuery": { "title": "Max results per query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap per query and per surface: up to N Local Services Ads and up to N local-pack cards. Google lists at most 20 ads per category and city.", "default": 20 }, "maxPages": { "title": "Max pages per query", "minimum": 1, "maximum": 10, "type": "integer", "description": "Kept for compatibility. The HTTP version reads one Local Services listing and one SERP per query; there is nothing to paginate.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Local Services Ads are fetched through Apify RESIDENTIAL proxies with a US exit regardless of the group chosen here (Google returns an empty listing to other exits); the SERP goes through Apify's Google SERP proxy. Custom proxy URLs, if given, are used as-is for the ads.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }