{ "openapi": "3.0.1", "info": { "title": "Google Local Services Ads Scraper (LSA Lead Extractor)", "description": "Extract Google Local Services Ads (LSA) leads: business name, phone number, rating, reviews, badges, years in business and service area.", "version": "1.0", "x-build-id": "R69pkOFqNMS3an3T7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/optirefine~google-local-service-ads-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-optirefine-google-local-service-ads-extractor", "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/optirefine~google-local-service-ads-extractor/runs": { "post": { "operationId": "runs-sync-optirefine-google-local-service-ads-extractor", "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/optirefine~google-local-service-ads-extractor/run-sync": { "post": { "operationId": "run-sync-optirefine-google-local-service-ads-extractor", "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", "locations" ], "properties": { "searchQueries": { "title": "Services to search for", "type": "array", "description": "The services you want providers for. Everyday wording works best — 'plumbers' and 'electricians' return more results than Google's formal category names.", "default": [ "plumbers" ], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities or areas to search in — always include the state, province or country, e.g. 'Austin, TX' or 'London, UK', not just 'Austin' or 'London'. Without a region, the country can't be determined and the run falls back to the US (it logs a warning when this happens) — which returns zero results if that's the wrong country for that location. The detected country also selects the matching proxy automatically.", "default": [ "Austin, TX" ], "items": { "type": "string" } }, "maxLeads": { "title": "Maximum leads (cap, not a target)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stops the run once this many providers have been saved. IMPORTANT: Google returns a maximum of 20 providers per service per location, so a single service in a single city yields at most 20 results no matter how high you set this. To get more leads, add more locations or more services.", "default": 1000 }, "minRating": { "title": "Minimum star rating (whole numbers, 0-5)", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only save providers rated at or above this — use a whole number (4, not 4.5). Leave it empty to keep every provider regardless of rating. Setting it to 0 is NOT the same as leaving it empty: providers with no rating yet (brand-new advertisers) are excluded whenever this filter is set, including when set to 0." }, "minReviews": { "title": "Minimum number of reviews", "minimum": 0, "type": "integer", "description": "Only save providers with at least this many reviews — useful for filtering out newly listed businesses. Leave it empty to keep everyone. As with the rating filter, setting this to 0 still excludes providers Google shows no review count for; only an empty field includes them." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "REQUIRED for real results. Google only shows Local Services Ads to visitors in the same country as the search location, so the run automatically forces the proxy country to match each location. Residential proxies are strongly recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "countryCode": { "title": "Force a country (advanced)", "type": "string", "description": "Two-letter ISO country code (US, GB, CA, DE…) that overrides the detected country for EVERY location in this run, not just ambiguous ones, and also silences the ambiguous-location warning. Leave it empty unless all your locations are in the same country — mixing 'Austin, TX' with a GB override sends the Austin search to a GB proxy and returns nothing." }, "languageCode": { "title": "Language", "type": "string", "description": "Two-letter language code used for Google's interface and result text.", "default": "en" } } }, "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 } } } } } } } } } }