Apple Maps API
Apple Maps is the map service built into Apple devices. places reads up to 50 places in one call from their numeric Apple Maps IDs and returns address, coordinates, phone, website, category, weekly hours, amenities, photos and rating details for each.
Get place IDs from the apple_maps_id column of DuckDuckGo Maps results, or from the auid in an Apple Maps share link. Ratings shown on Apple Maps often come from partner review sites, so each row names the site in rating_source. A call costs the same for one ID or fifty.
Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Apple Maps action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Place detailsplaces | Read up to 50 Apple Maps places in one call from their numeric IDs. | $0.56 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Apple Maps action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and features of the official site are not part of the EveryInfra API unless this page lists them.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
placesPlace details Read up to 50 Apple Maps places in one call from their numeric IDs. Each row has address, coordinates, phone, website, category, weekly hours, amenities, photos, price level, rating with the site it comes from, and a few representative reviews. Get IDs from DuckDuckGo Maps results or an Apple Maps link; one call costs the same for one ID or fifty. | place_ids | language | Sync delivery | — | $0.56 per 1,000 requests | place_id · name · url · category · categories · address · city · state · postal_code · country_code · lat · lng · timezone · phone · website · rating · rating_scale · review_count · rating_source · price · open_state · opening_hours · amenities · image_urls · top_reviews · is_claimed · platform |
What do the Apple Maps places parameters mean?
Read up to 50 Apple Maps places in one call from their numeric IDs. Each row has address, coordinates, phone, website, category, weekly hours, amenities, photos, price level, rating with the site it comes from, and a few representative reviews. Get IDs from DuckDuckGo Maps results or an Apple Maps link; one call costs the same for one ID or fifty.
Full API reference: parameters, code samples, response example and healthplace_idsRequired- A list of 1 to 50 numeric Apple Maps place IDs, such as
["12971322601039101590"], taken from theapple_maps_idof DuckDuckGo Maps rows or theauidin an Apple Maps link. A call costs the same for one ID or fifty; IDs that are not digits are rejected before any charge.Apple Developer Documentation: Identifying Unique Locations with Place IDs — Apple's developer documentation says a Place ID keeps identifying the same point of interest over its lifetime and can be used to fetch that place's information. The source confirms only that Apple Maps places have stable unique identifiers; the `place_ids` of this API are the all-digit place IDs (auid) found in Apple Maps links, which are written differently from MapKit's alphanumeric Place IDs and cannot be swapped with them. It does not describe hours, amenities or rating fields. · Checked languageOptional- The language of the returned place details, such as
en-US,zh-CNorja-JP; a two-letter code such asenalso works. Defaulten-US.
How to use the Apple Maps API
- 01Choose a platform action from the public catalog.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Read the result from the response. For an asynchronous action, poll the returned job ID.
- 04Store the response fields that your application needs.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"apple_maps","action":"places","params":{"place_ids":"<place_ids>"}}'
Apple Maps API questions
What can I retrieve with the Apple Maps API?
Set platform to apple_maps. The current catalog lists place details. These action names identify different Apple Maps objects or views; they are not interchangeable search modes.
Which input starts the Apple Maps places request?
A list of 1 to 50 numeric Apple Maps place IDs, such as ["12971322601039101590"], taken from the apple_maps_id of DuckDuckGo Maps rows or the auid in an Apple Maps link. A call costs the same for one ID or fifty; IDs that are not digits are rejected before any charge. Send it as place_ids inside params.
Which fields can Apple Maps places return?
Its declared schema includes place_id, name, category, and categories. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Apple Maps action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.