{ "openapi": "3.0.1", "info": { "title": "Apple Maps (Mapas) Scraper - Places, Ratings, Phone + Website", "description": "Search Apple Maps by keyword and city: public places with Apple place ID, name, category, address, coordinates, business phone and website, and aggregate rating with its source. No login, no cookies. Empty terms and status rows are free.", "version": "0.0", "x-build-id": "hdyN5eD5XsWPdky0J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~apple-maps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-apple-maps", "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/lanternlab318~apple-maps/runs": { "post": { "operationId": "runs-sync-lanternlab318-apple-maps", "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/lanternlab318~apple-maps/run-sync": { "post": { "operationId": "run-sync-lanternlab318-apple-maps", "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": [ "searchQueries", "location" ], "properties": { "searchQueries": { "title": "Search terms", "type": "array", "description": "One Apple Maps search term per line, in the local language where you can - \"ร้านกาแฟ\" returns more Thai coffee shops than \"coffee shop\" does. Each term is searched separately and its rows are labelled with it. A place that matches several of your terms is returned once and charged once.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "The city, district or address to search in: \"São Paulo\", \"Bangkok\", \"Jakarta Selatan\", \"Ciudad de México\". Apple Maps resolves it first, and the run reports what it resolved to. A city is searched across its whole area; a street address is searched from that one point." }, "maxPlaces": { "title": "Max places per search term", "minimum": 1, "maximum": 300, "type": "integer", "description": "Upper bound on the places one search term may produce. Apple Maps serves at most 10 places per search and offers no second page, so a term is searched from several points across the location until it has this many. More points cost more requests, which is why this is capped at 300.", "default": 50 }, "includeRating": { "title": "Also read each place's own page for its rating", "type": "boolean", "description": "The search result carries name, category, full address, coordinates and often the business phone and website - but no rating. With this on, each place's own public page is read for its aggregate rating (and for the fuller phone and website Apple shows there), which is one extra request per place against one request per 10 places for the search itself. Turning it off makes a run about 10x cheaper in requests and leaves every rating null. About 7 in 10 places carry a rating at all; the rest are null with this on.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Optional BCP 47 language tag Apple Maps should answer in, for example \"pt-BR\", \"th-TH\", \"id-ID\", \"es-MX\". It decides the language of names, categories and addresses. Leave empty to let Apple choose from the exit IP." }, "maxUpstreamRequests": { "title": "Max Apple Maps requests", "minimum": 1, "type": "integer", "description": "Hard ceiling on the HTTP requests this run sends to Apple Maps: the two token requests, the location lookup, every search point, every place page and every retry. At the ceiling collection stops - the terms not reached are written with partialReason \"upstream_request_cap\" and the run then ends normally. Leave empty and the Actor works a ceiling out from your inputs and limits, so a run is never unbounded." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy the requests to Apple Maps go through. Residential exits are the default, so a search is answered the way it would be in the country you are collecting. A run that is refused anyway reports blocked with the refusing response's own signature, never zero results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }