{ "openapi": "3.0.1", "info": { "title": "Local Business Leads: Phone, Website & Rating by Place", "description": "Find local businesses by category and place, for example 500 plumbers within 40 km of Columbus. Each lead has phone, website, address, rating and review count. Filter by rating, reviews, website and claimed listings. $2 per 1,000 leads, charged per lead returned.", "version": "1.0", "x-build-id": "rRJTsaDfAnho2hffw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ensorcelling_melilot~local-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ensorcelling_melilot-local-leads", "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/ensorcelling_melilot~local-leads/runs": { "post": { "operationId": "runs-sync-ensorcelling_melilot-local-leads", "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/ensorcelling_melilot~local-leads/run-sync": { "post": { "operationId": "run-sync-ensorcelling_melilot-local-leads", "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": [ "categories" ], "properties": { "categories": { "title": "Business categories", "type": "array", "description": "What kind of business to find, one per line, up to 10. Use Google Maps category names such as plumber, dentist, hair salon, roofing contractor or italian restaurant. Names with spaces are fine. Unknown names are reported with suggestions.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region or address to search around, for example Columbus, Ohio, USA or Manchester, UK. Leave empty if you fill in latitude and longitude below." }, "radiusKm": { "title": "Search radius (km)", "minimum": 1, "maximum": 100, "type": "integer", "description": "How far from the location to look, between 1 and 100 km. Leave empty to fit the place you typed (a city is searched as a city), up to 100 km." }, "latitude": { "title": "Latitude (optional)", "type": "string", "description": "Exact search centre, for example 39.9612. Use together with longitude instead of a location name." }, "longitude": { "title": "Longitude (optional)", "type": "string", "description": "Exact search centre, for example -82.9988. Use together with latitude instead of a location name." }, "maxResults": { "title": "Maximum leads", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many leads. You are charged per lead saved, so this is also your spending limit.", "default": 100 }, "minRating": { "title": "Minimum star rating", "type": "string", "description": "Only businesses rated at least this many stars, for example 4 or 4.5. Leave empty for any rating." }, "minReviews": { "title": "Minimum number of reviews", "minimum": 0, "type": "integer", "description": "Only businesses with at least this many Google reviews. Use it to skip brand-new or inactive listings. Leave empty for no minimum." }, "requirePhone": { "title": "Phone number required", "type": "boolean", "description": "Only return businesses that list a phone number. Almost all do.", "default": true }, "requireWebsite": { "title": "Website required", "type": "boolean", "description": "Only return businesses that list a website. Useful for email outreach or website audits.", "default": false }, "claimedOnly": { "title": "Claimed listings only", "type": "boolean", "description": "Only businesses whose Google listing has been claimed by its owner, a sign the business is active.", "default": false }, "sortBy": { "title": "Order of results", "enum": [ "reviews", "rating" ], "type": "string", "description": "Which businesses come first when there are more matches than your maximum. Most reviews puts the busiest, best-known businesses first.", "default": "reviews" } } }, "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 } } } } } } } } } }