100 free credits. No credit card required.Start building
Logo
Apple Maps logoApple Maps API

Get Apple Maps place and rating data with one API

Search Apple Maps for places in a map area and look up places by id, with ratings, hours, contact details and amenities, as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Apple Maps logo
/v1/apple_maps

2 active endpoints. Search and places.

  • GET /v1/apple_maps/search
  • GET /v1/apple_maps/places

What Apple Maps endpoints does SocialCrawl ship?

Two read endpoints for public Apple Maps data. Search a map area for places, then read up to 50 places at once by their Apple Maps id.

Place search

1 credit
/v1/apple_maps/search

About 20 places a call for a search term in a map box (bbox, west,north,east,south in decimal degrees) or around a point (lat with lng). Each place has its Apple Maps id, name, Apple Maps link, category, address, city, country, phone, coordinates, photos, price level, opening hours by weekday, open now status and website. Search ratings are Yelp's out of 5, with the review count, up to three review snippets and the Yelp id for joining the yelp endpoints. strict_bbox is true by default, and false lets in places just outside the box. One call covers one box, so tile a city with smaller boxes. A point covers a much smaller area than a box. Standard tier (1 credit).

query, bbox or lat and lng, strict_bbox

/v1/apple_maps/places

1 to 50 places by Apple Maps id in one call, returned in the order sent, with an optional language such as fr-FR. Adds the description, categories, address split into city, region and postal code, whether the business claimed the listing, amenities, the menu link and the ordering link. Apple rates 0 to 100 with Food & Drink, Atmosphere and Customer Service sub-ratings, and places Apple has not rated carry Yelp's out of 5. place.ext.rating_source names the rater. An unknown id is left out and named in data._warnings while the other places still come back. A lookup where no id is known is empty and free. Standard tier (1 credit).

ids, language

Apple Maps API2 endpoints supported
View docs
Places

Returns up to 50 Apple Maps places by id in one call, each with its rating and rater, address, phone, hours, amenities, photos, website and menu.

Use it to refresh places you already found, compare their ratings and hours, or enrich a list of Apple Maps ids in bulk.

1 credit

GET/v1/apple_maps/places?ids=5144915183449522016%2C4568414994170597789

ids · One to 50 Apple Maps place ids, comma-separated, for example 5144915183449522016. GET /v1/apple_maps/search returns them in place.id.

$ curl https://www.socialcrawl.dev/v1/apple_maps/places?ids=5144915183449522016%2C4568414994170597789 \
    -H "x-api-key: sc_YOUR_API_KEY"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Apple Maps API works

Apple Maps is a normal SocialCrawl data surface. You call GET /v1/apple_maps/… with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No Apple account or developer token is needed for public reads. The same key works across SocialCrawl platforms.

GET with query params

Search takes query (up to 500 characters) with a bbox or a lat and lng pair. Places takes ids, 1 to 50 Apple Maps ids separated by commas. Formats are validated before any charge.

Pay in credits, not seats

Every Apple Maps route costs 1 credit, and a call for 50 ids is still one call. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists carry items and a total.

The usual integration chain

Most products find places in an area first, then read the ones that matter in bulk.

01Search a map box
GET /v1/apple_maps/search?query=…&bbox=…

PlaceList of about 20 places with Yelp rating and review snippets

One call covers one box. Tile a city with smaller boxes to cover it.

02Read places in bulk
GET /v1/apple_maps/places?ids=…

PlaceList of up to 50 places with Apple rating, hours and amenities

Take place.id from each search row. Places come back in the order you sent them.

03Read the Yelp reviews
GET /v1/yelp/business/reviews?id=…

Reviews from the Yelp endpoints

place.ext.yelp_id on a search row is the id GET /v1/yelp/business/reviews takes.

request
GET /v1/apple_maps/search?query=coffee&bbox=-74.000,40.765,-73.970,40.745
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/apple_maps/places?ids=5144915183449522016,4568414994170597789
response envelope
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "5144915183449522016",
        "name": "Culture Espresso",
        "category": "Espresso Bar",
        "address": "72 W 38th St, New York, NY 10018",
        "rating": { "value": 93, "max": 100 },
        "reviews_count": 98,
        "ext": {
          "rating_source": "Apple",
          "category_ratings": { "Food & Drink": 97 },
          "weekly_hours": { "monday": ["07:00 - 19:00"] }
        }
      }
    ],
    "total": 1
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.

PlaceList (search)search

items[] with id, name, url, category, rating with its scale, reviews_count, address, city, country, phone, coordinates, photos, price level, ext.rating_source, ext.review_snippets, ext.yelp_id, ext.weekly_hours

PlaceList (places)places

items[] in the order sent, with description, categories, region, postal code, verified, ext.amenities, ext.menu_url, ext.order_url; _warnings names any unknown id

Ratings and their scaleplaces

rating.value with rating.max (100 for Apple, 5 for Yelp), ext.rating_source, ext.category_ratings for Food & Drink, Atmosphere and Customer Service

Yelp joinsearch

ext.yelp_id and up to three ext.review_snippets on each search row, ready for the yelp endpoints

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Apple Maps is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds the apple_maps route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public data is read live, with retries on 5xx or network errors and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    Apple Maps data is mapped to the PlaceList archetype, with the rating source, hours, amenities and Yelp id in place.ext, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search and places: 1 credit
  • places: up to 50 ids for 1 credit
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Places lookup where no id is known: empty and free
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • Unknown ids are left out and named in data._warnings
  • Search: about 20 places a call, one box per call

How SocialCrawl gets Apple Maps data

Apple Maps is public read data. We normalize it into the SocialCrawl schema so your code does not learn a second vendor SDK.

What Apple Maps is for this API

Public Apple Maps place listings: business details, opening hours, Apple ratings and amenities, plus the Yelp rating and review snippets Apple Maps shows in search.

How SocialCrawl reaches it

Public data is read on request and normalized server-side. You never run an Apple developer account or a Yelp integration.

What leaves our edge

PlaceList for both routes. The rater is named in place.ext.rating_source and every rating keeps its own scale, so a 93 out of 100 is never turned into a 4.65 out of 5.

What we do not ship live

No reviewer names, no directions or routing, and no business-owner tools.

field map sketch
Apple Maps place→ place.*Apple Maps id, name, link, category, address, phone, coordinates, website
rating, review count and snippets→ place.ext.rating_source / review_snippets / yelp_idthe rater, review count, snippets and the Yelp id for the yelp endpoints
hours and amenities→ place.ext.weekly_hours / amenitiesopening hours by weekday and the amenity list

What this API is used for

The jobs this API is most often used for.

2active Apple Maps endpoints in the registry
1credit per call on every Apple Maps route

Local business lists, listing checks and review joins

Callers search a map box first, then read the places that matter in bulk. Apple ratings on their own 0 to 100 scale next to Yelp's out of 5, 50 places per call for 1 credit, and a Yelp id on every search row for joining the yelp endpoints.

Live misses read the public data on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Local business lists

Python, scheduled jobs

search with smaller boxes to tile a city, then places for up to 50 ids at a time to fill in phone, website and hours.

Listing accuracy checks

Node, warehouse loads

places for each id you manage to compare opening hours, phone and address with what Apple Maps shows, and to read whether the listing was claimed.

Review enrichment

Python, notebooks

search for a category in a box, then take place.ext.yelp_id into the yelp reviews endpoint for the full review text.

How to call the Apple Maps API

Every Apple Maps route is 1 credit. Cache hits are free.

curl "https://www.socialcrawl.dev/v1/apple_maps/search?query=coffee&bbox=-74.000,40.765,-73.970,40.745" \n  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/apple_maps/places?ids=5144915183449522016,4568414994170597789" \n  -H "x-api-key: sc_your_api_key_here"
Apple Maps logoApple Maps on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Apple Maps API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl Apple Maps API cover?
It covers 2 endpoints: Places and Search. Search places for a query in a map box, then read places by Apple Maps id, in the same unified JSON as the other 94 platforms.
Do I need an Apple developer account or MapKit token?
No. You call SocialCrawl with one SocialCrawl API key, so there is no Apple developer account, MapKit token or Apple key to manage.
Can I get Apple Maps ratings and reviews?
Yes. Search returns the Yelp rating out of 5, the review count and up to three review snippets for each place. The places endpoint returns the rating with its scale and who rated it, including Apple's own 0 to 100 score with Food & Drink, Atmosphere and Customer Service sub-ratings.
How do I find Apple Maps place ids?
Call GET /v1/apple_maps/search. Every place comes back with its Apple Maps id in place.id, and you pass those ids to GET /v1/apple_maps/places to read the full record.
How much does the Apple Maps API cost?
Every Apple Maps route costs 1 credit a call and cache hits are free. A new account gets 100 free credits with no card.
Is scraping Apple Maps data legal?
SocialCrawl returns publicly available Apple Maps data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Apple Maps's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Apple Maps scraping API vs the official Apple Maps API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Apple Maps endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the Apple Maps API reference in the docs

🤖 AI agent or LLM? Read this page as markdown