{ "openapi": "3.0.1", "info": { "title": "Open Places Lead Finder: Local Business List (Overture)", "description": "Local business list by city or map area and category, with name, address, phone and website. Built from the open Overture Maps places dataset, no scraping. Closed, duplicate and low-confidence rows are filtered out. A Google Maps scraper alternative for B2B lead lists.", "version": "1.0", "x-build-id": "t0mvwTkDyGU3OaecR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/atesen-software~open-places-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-atesen-software-open-places-lead-finder", "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/atesen-software~open-places-lead-finder/runs": { "post": { "operationId": "runs-sync-atesen-software-open-places-lead-finder", "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/atesen-software~open-places-lead-finder/run-sync": { "post": { "operationId": "run-sync-atesen-software-open-places-lead-finder", "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": { "city": { "title": "City", "type": "string", "description": "City, town or village, for example Austin, Manchester or Toronto. Use it together with Country. Only places inside the city boundary in Overture Maps are kept (a circle of 8 km around the centre when the city has no boundary). Ignored when you fill in Bounding box.", "default": "Austin" }, "country": { "title": "Country (ISO-2)", "type": "string", "description": "Two-letter country code of the city, for example US, GB, CA, DE, FR, AU.", "default": "US" }, "region": { "title": "Region or state (optional)", "type": "string", "description": "Only needed when several cities share a name. Use the state or region code, for example TX or US-TX." }, "bbox": { "title": "Bounding box (optional)", "type": "array", "description": "Map area as [minLongitude, minLatitude, maxLongitude, maxLatitude], for example [-79.65, 43.58, -79.30, 43.80] for Toronto. Use it instead of City and Country. At most 2.5 degrees on a side." }, "categories": { "title": "Business categories", "type": "array", "description": "Plain business types such as dentist, plumber, restaurant, lawyer, accountant, real estate agent, gym, hair salon, electrician, auto repair, hotel. See the README for the full list. Other names are tried as Overture category values. Leave empty to get every category.", "items": { "type": "string" } }, "minConfidence": { "title": "Minimum confidence", "minimum": 0, "maximum": 1, "type": "number", "description": "Overture's own 0 to 1 score that the place really exists. Higher means fewer rows and cleaner data. 0.8 is a good starting point.", "default": 0.8 }, "requirePhoneAndWebsite": { "title": "Only businesses with phone and website", "type": "boolean", "description": "Keep a business only when it has a phone number and a website of its own (social media and listing pages do not count).", "default": true }, "dropMobileNumbers": { "title": "Drop mobile phone numbers", "type": "boolean", "description": "In countries where mobile numbers can be recognised (for example GB, DE, FR, ES, IT, NL, AU) remove them. A mobile number often belongs to a one-person business, which makes it personal data.", "default": true }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many businesses. You are charged only for the rows written.", "default": 100 }, "includeClosed": { "title": "Include closed businesses", "type": "boolean", "description": "By default places that Overture marks as permanently or temporarily closed are left out.", "default": false } } }, "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 } } } } } } } } } }