{ "openapi": "3.0.1", "info": { "title": "Local Business Leads: Emails, Phones by City & Category", "description": "Build local business lead lists by city and category with email, phone, website and social links from open Overture Maps Places data. Useful for lead generation, B2B prospecting, business directories, Google Maps alternatives, email finding and local SEO. No scraping, proxies or ToS evasion.", "version": "0.1", "x-build-id": "mqHnnCbhPsAz8qfRw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/interconnected_seaport~overture-local-business-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-interconnected_seaport-overture-local-business-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/interconnected_seaport~overture-local-business-leads/runs": { "post": { "operationId": "runs-sync-interconnected_seaport-overture-local-business-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/interconnected_seaport~overture-local-business-leads/run-sync": { "post": { "operationId": "run-sync-interconnected_seaport-overture-local-business-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", "properties": { "locations": { "title": "Locations", "type": "array", "description": "City, town or address, one per line (e.g. \"Uppsala, Sweden\", \"Hamburg, Germany\"). Up to 25 per run. Each is searched within the radius below.", "default": [ "Uppsala, Sweden" ], "items": { "type": "string" } }, "categories": { "title": "Business categories", "type": "array", "description": "Plain words such as dentist, hairdresser, plumber, lawyer, restaurant, gym, accountant, car repair (also some Swedish words: tandläkare, frisör, advokat, rörmokare). You can also use Overture category ids such as dental_clinic, pizza_restaurant or health_care (parent categories include their children). Leave empty for all categories.", "default": [], "items": { "type": "string" } }, "radiusKm": { "title": "Search radius (km)", "minimum": 0.2, "maximum": 50, "type": "number", "description": "Distance from the geocoded location centre. 0.2 to 50.", "default": 10 }, "requireContact": { "title": "Require contact details", "enum": [ "any", "email_or_phone", "email", "phone", "website", "none" ], "type": "string", "description": "Only return businesses that have at least this contact data. 'any' = email, phone or website. Unmatched businesses are not returned and not charged.", "default": "any" }, "minConfidence": { "title": "Minimum confidence (0-1)", "minimum": 0, "maximum": 1, "type": "number", "description": "Overture's confidence that the place exists. 0.5 is a sensible default; raise to 0.8 for cleaner lists.", "default": 0.5 }, "excludeClosed": { "title": "Exclude closed businesses", "type": "boolean", "description": "Skip places flagged as permanently or temporarily closed.", "default": true }, "nameContains": { "title": "Name contains (optional)", "type": "string", "description": "Only businesses whose name contains this text (case-insensitive), e.g. 'tandläkarna'." }, "maxResultsPerLocation": { "title": "Max results per location", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Best-confidence businesses first. Free Apify plan: 25 per run in total.", "default": 100 }, "centerLatitude": { "title": "Custom centre latitude (optional)", "type": "number", "description": "Use together with longitude to search around exact coordinates instead of (or in addition to) locations." }, "centerLongitude": { "title": "Custom centre longitude (optional)", "type": "number", "description": "See latitude." } } }, "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 } } } } } } } } } }