{ "openapi": "3.0.1", "info": { "title": "Apple Maps Business Listings Scraper", "description": "Search Apple Maps by business category, keyword, location, coordinates, or place URL. Export stable place IDs, names, categories, addresses, phones, websites, coordinates, and source URLs for recurring lead and directory refreshes.", "version": "0.1", "x-build-id": "mUJSdvsl5hJH5q5Ut" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~apple-maps-business-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-apple-maps-business-listings-scraper", "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/automation-lab~apple-maps-business-listings-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-apple-maps-business-listings-scraper", "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/automation-lab~apple-maps-business-listings-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-apple-maps-business-listings-scraper", "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": { "searchTerms": { "title": "Business categories or keywords", "maxItems": 50, "type": "array", "description": "Up to 50 categories or keywords. Each trimmed non-empty value is a separate ranked Apple Maps search, not an exact-name filter. Results are globally deduplicated.", "items": { "type": "string", "minLength": 1 } }, "location": { "title": "Location", "type": "string", "description": "Fallback city, neighborhood, postal code or address for jobs without a center. Ignored when coordinates are supplied, or every supplied URL has ll/center and there are no keyword jobs. Not geocoded when unused." }, "coordinates": { "title": "Coordinates", "required": [ "latitude", "longitude" ], "type": "object", "description": "Optional exact search center. Overrides location for keyword searches and URLs without ll/center. Explicit URL ll/center takes precedence for that URL.", "properties": { "latitude": { "title": "Latitude", "description": "Decimal latitude of the search center.", "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "title": "Longitude", "description": "Decimal longitude of the search center.", "type": "number", "minimum": -180, "maximum": 180 } } }, "appleMapsUrls": { "title": "Apple Maps URLs", "maxItems": 100, "type": "array", "description": "Up to 100 HTTPS maps.apple.com or beta.maps.apple.com URLs with q or query. auid filters to an exact stable place ID. ll or center must be valid latitude,longitude; ll takes precedence if both are supplied (both validated). span/zoom does not define an exhaustive radius. Short links and ID-only URLs are unsupported.", "items": { "type": "string", "pattern": "^https://(?:beta\\.)?maps\\.apple\\.com/" } }, "countryCode": { "title": "Country code", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter ISO country code used to limit Apple Maps results.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language tag for returned labels, such as en-US or de-DE.", "default": "en-US" }, "maxResultsPerSearch": { "title": "Maximum results per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum newly stored unique listings per keyword or URL (default 50); duplicates across jobs are not billed or stored again. Finite integers are clamped to 1–200; zero is not unlimited.", "default": 50 }, "maxItems": { "title": "Maximum total results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Global cap on stored listing rows across all searches and URLs (default 200). Finite integers are clamped to 1–1000; zero is not unlimited. Later jobs are skipped once reached.", "default": 200 }, "maxRequestRetries": { "title": "Request retries", "minimum": 0, "maximum": 6, "type": "integer", "description": "Retries for temporary network, rate-limit, and upstream server errors.", "default": 3 } } }, "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 } } } } } } } } } }