{ "openapi": "3.0.1", "info": { "title": "Local Business Lead Builder", "description": "Build local business lead lists from Google Maps. Enter a category and a place, or a search like dentist in Austin, TX. Get one row per business with website, phone, full address, coordinates, categories, rating, review count, and hours. No Google API key. CSV or Clay ready.", "version": "0.1", "x-build-id": "nuWvAYKL0nfEanNxh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~local-business-lead-builder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-local-business-lead-builder", "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/mambalabs~local-business-lead-builder/runs": { "post": { "operationId": "runs-sync-mambalabs-local-business-lead-builder", "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/mambalabs~local-business-lead-builder/run-sync": { "post": { "operationId": "run-sync-mambalabs-local-business-lead-builder", "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", "properties": { "queries": { "title": "Searches", "type": "array", "description": "One search per line, the way you would type it in Google Maps: a business category and a place, for example dentist in Austin, TX. Up to 100 searches per run. Leave empty when you use Categories and Locations.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Business categories, for example roofing contractor or dental clinic. Each category is searched in every location below. Use this or Searches, or both.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Places to search in: a city with its state or country (Denver, CO or Manchester, UK), a ZIP code, or a neighborhood. Each is combined with every category above.", "items": { "type": "string" } }, "max_places_per_query": { "title": "Max places per search", "type": "string", "description": "Stop each search after this many place rows. Google Maps lists about 20 businesses per page; dense categories in large cities go past 200.", "default": "20" }, "min_rating": { "title": "Minimum rating", "type": "string", "description": "Keep only businesses rated at or above this, for example 4.0. Filtered businesses are not returned and are not charged." }, "min_reviews": { "title": "Minimum reviews", "type": "string", "description": "Keep only businesses with at least this many Google reviews. Filtered businesses are not charged." }, "require_website": { "title": "Only businesses with a website", "enum": [ "true", "false" ], "type": "string", "description": "Skip businesses with no website on their Google Maps profile. Skipped businesses are not charged.", "default": "false" }, "require_phone": { "title": "Only businesses with a phone", "enum": [ "true", "false" ], "type": "string", "description": "Skip businesses with no phone number on their Google Maps profile. Skipped businesses are not charged.", "default": "false" }, "dedupe": { "title": "Skip repeats", "enum": [ "true", "false" ], "type": "string", "description": "When on, a business that an earlier search in the same run already returned is skipped and not charged. When off, it is returned again with Repeat set to true and charged again.", "default": "true" }, "language": { "title": "Language", "type": "string", "description": "Language of the Google Maps results as a two letter code, for example en, de, or fr.", "default": "en" }, "country": { "title": "Country for results", "type": "string", "description": "Two letter country code Google uses to rank results, for example us, gb, or de. Name the place in the search too.", "default": "us" }, "max_charge_usd": { "title": "Max charge per run (USD)", "type": "string", "description": "Stop before a row would push this run past this amount. Empty: no limit beyond the one you set in Apify." }, "proxy_mode": { "title": "Proxy", "enum": [ "auto", "residential" ], "type": "string", "description": "Auto sends requests through the Apify proxy pool and moves a request to residential addresses only when Google refuses it. Residential only is slower. This is a reliability choice; under pay per event the proxy is not billed to you.", "default": "auto" }, "source_tag": { "title": "Source tag", "type": "string", "description": "Internal attribution tag for published tasks. Leave empty." } } }, "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 } } } } } } } } } }