# Apple Maps Places API (https://www.socialcrawl.dev/platforms/apple_maps/places) > Returns Apple Maps places by their Apple Maps ids, up to 50 in one call and 1 credit, one item per place in the order sent: name, Apple Maps link, category and categories, rating with its scale and rater (Apple rates 0 to 100 in place.rating.max 100, with Food & Drink, Atmosphere and Customer Service sub-ratings in place.ext.category_ratings; otherwise a partner such as Yelp rates out of 5; place.ext.rating_source says which), review count, price level, address with city, region, postal code and country, phone, coordinates, whether the business has claimed the listing (place.verified), description, photos, opening hours by weekday, amenities, website, and menu and ordering links. An id Apple Maps does not know is left out and named in data._warnings; every other place still comes back (a batch with unknown ids is looked up in parts, and any id not reached in time is listed there too). A lookup where no id is known returns an empty list and is not billed. GET /v1/apple_maps/search returns ids in place.id. TL;DR: `GET /v1/apple_maps/places` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `ids` | yes | One to 50 Apple Maps place ids, comma-separated, for example 5144915183449522016. GET /v1/apple_maps/search returns them in place.id. | | `language` | no | Language and regional formatting as a locale, for example en-US, fr-FR or ja-JP (default en-US). | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/apple_maps/places" \ --data-urlencode "ids=5144915183449522016,4568414994170597789" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### How do I get Apple Maps place details with an API? Send GET /v1/apple_maps/places with ids, one to 50 Apple Maps ids separated by commas, for example 5144915183449522016,4568414994170597789. Each place comes back in the order you sent. ### What does the Apple Maps Places API return? Each place has its name, link, category, rating with its scale and rater, review count, price level, address parts, phone, coordinates, opening hours, amenities, photos, website, and menu and ordering links. ### Why do some Apple Maps ratings use a 0 to 100 scale? Apple rates many places itself on a 0 to 100 scale, with Food & Drink, Atmosphere and Customer Service sub-ratings. Other places carry a partner rating such as Yelp's out of 5, and the response says which rater and scale applies. ### What happens when an Apple Maps id is unknown? The unknown id is left out and named in a warning, and every other place still comes back. A lookup where no id is known returns an empty list. ### How much does the Apple Maps Places API cost? Each call costs 1 credit on the standard tier however many ids you send, and cache hits are free. A new account gets 100 free credits with no card. See the full Apple Maps API: https://www.socialcrawl.dev/platforms/apple_maps ## Pricing - Standard endpoints: 1 credit per call - Advanced endpoints: 5 credits per call - Premium endpoints: 10 credits per call - 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire. - Full pricing: https://www.socialcrawl.dev/pricing ## Explore with AI Questions this API answers, phrased for an AI assistant: - How do I get Apple Maps place details by id with an API? - Is there an API to read up to 50 Apple Maps places in one call? - How do I get Apple Maps opening hours and ratings as JSON?