{ "openapi": "3.0.1", "info": { "title": "Apple Maps Scraper - Phones, Ratings, Hours, Amenities & Photos", "description": "Extract place data from Apple Maps at scale. Get phone numbers, ratings, opening hours, amenities, photos, and full addresses for any business. Search by query + location, paste place URLs, or replay search URLs. 30+ fields per place. Parallel requests. No Apple account needed. $2.99/1,000 places.", "version": "0.0", "x-build-id": "J0UWkA0c9TnzZr9k0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~apple-maps-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-apple-maps-scraper-pro", "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/zen-studio~apple-maps-scraper-pro/runs": { "post": { "operationId": "runs-sync-zen-studio-apple-maps-scraper-pro", "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/zen-studio~apple-maps-scraper-pro/run-sync": { "post": { "operationId": "run-sync-zen-studio-apple-maps-scraper-pro", "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": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Search for places by query and location. The location is automatically converted to coordinates — use any city, neighborhood, or address.

Each query searches a ~5 km radius. All queries run in parallel.", "items": { "type": "object", "required": [ "query", "location" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "What to search for — works like the Apple Maps search bar.

Examples:
• coffee shops
• dentist
• Italian restaurant
• EV charging station", "editor": "textfield" }, "location": { "title": "Location", "type": "string", "description": "Where to search. Gets converted to coordinates automatically.

Examples:
• Brooklyn, New York
• Shibuya, Tokyo
• 1600 Amphitheatre Parkway, Mountain View, CA

More specific = more accurate. Soho, London is better than London.", "editor": "textfield" }, "maxResults": { "title": "Max Results", "type": "integer", "description": "Override the global Max Results per Query for this specific search. Leave empty to use the global setting.", "minimum": 1, "maximum": 1000, "editor": "number" } } } }, "maxResults": { "title": "Max Results per Query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum places to return per search query. Applies to all search queries and search URLs unless overridden per-query.", "default": 50 }, "placeUrls": { "title": "Place URLs", "type": "array", "description": "Direct links to specific Apple Maps places. Fetches full details for each.

Accepted formats:
• https://maps.apple.com/place?auid=12345
• https://maps.apple.com/place?place-id=I918CB7E77B4C7910

Right-click any place on maps.apple.com → Share → Copy Link.", "items": { "type": "string" } }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Apple Maps search URLs with query and coordinates baked in. Useful for replaying a specific search from your browser.

Format: https://maps.apple.com/search?query=coffee+shops¢er=40.71,-74.00&span=0.05,0.05

The span parameter controls search radius — smaller values = tighter area.", "items": { "type": "string" } }, "countryCode": { "title": "Country Code", "type": "string", "description": "Changes which places are returned — not just formatting.

Apple ranks places differently per country. The same search near the same coordinates gives different results with different country codes.

Example: café near Paris → US returns Café de Flore, FR returns Le Peloton Café.

Match this to where your target places are.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Changes which places are returned — not just translations.

Controls category names (Kaffeehaus vs Coffee Shop), address formatting, and result ranking.

Example: searching near Berlin with de-DE vs en-US returns different first results.", "default": "en-US" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional. Not required for small runs. Use datacenter proxies for large runs to avoid rate limiting." } } }, "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 } } }, "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 } } } } } } } } } }