# Apple Maps Search API (https://www.socialcrawl.dev/platforms/apple_maps/search) > Returns about 20 Apple Maps places for a query inside a map box (bbox, west,north,east,south as on GET /v1/yelp/search) or around a point (lat with lng), one item per place: the Apple Maps id in place.id (GET /v1/apple_maps/places takes it), name, Apple Maps link, category, Yelp's rating out of 5 and review count (place.ext.rating_source), up to three review snippets (place.ext.review_snippets), the Yelp id (place.ext.yelp_id, which the yelp endpoints take), price level, address, city, country, phone, coordinates, photos, opening hours by weekday, whether it is open now, and website. strict_bbox=false also lets in places just outside the box (default true). One call covers one box; search smaller boxes side by side to cover a city. Around a point the source looks at a much smaller area (one place in a test where the box around it gave 20), so prefer a box. A search can take up to 30 seconds. TL;DR: `GET /v1/apple_maps/search` 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 | | --- | --- | --- | | `query` | yes | What to look for, for example coffee or a business name (up to 500 characters). | | `bbox` | no | The map box to search, as four decimal degrees west,north,east,south, for example -74.000,40.765,-73.970,40.745. Send bbox, or lat with lng. | | `lat` | no | Latitude of the point to search around, sent with lng when there is no bbox. A point covers a much smaller area than a box. | | `lng` | no | Longitude of the point to search around, sent with lat when there is no bbox. | | `strict_bbox` | no | true (default) keeps only places inside the box; false also lets in places just outside it. (true \| false) | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/apple_maps/search" \ --data-urlencode "query=coffee" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### How do I search Apple Maps places with an API? Send GET /v1/apple_maps/search with query and either bbox (west,north,east,south) or lat with lng. You get about 20 places per call, each with its Apple Maps id, name, link, category, address, phone and coordinates. ### What does each Apple Maps search result include? Each place carries its Yelp rating out of 5, the review count, up to three review snippets, the Yelp id, price level, photos, weekly opening hours, whether it is open now, and its website. ### How do I limit a search to one map area? Pass bbox as west,north,east,south, for example -74.000,40.765,-73.970,40.745 with query coffee. Set strict_bbox to true to keep results inside the box, or give lat and lng to search around a point. ### How do I get more than about 20 places? Search smaller boxes side by side. One call answers one map box, so tile the area you care about and run one search per tile. ### How much does the Apple Maps Search API cost? Each call costs 1 credit on the standard tier, 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 search Apple Maps places in a map box with an API? - Is there an API that returns Apple Maps places with Yelp ratings? - How do I get local business data from Apple Maps as JSON?