# Apple Maps Local Business Search via x402atlas

> Apple Maps Local Business Search via x402atlas is a paid API for AI agents from places.use.x402atlas.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Search Apple Maps for local businesses by query and geographic center, returning ratings, reviews, address, phone, website, and Apple Maps place IDs as structured JSON.

## Facts

- Endpoint: GET https://places.use.x402atlas.com/apple/local
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apple-maps-local-business-search-via-x402atlas-63c537d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Pn7wbaJ1QWfdk-vEXnWtm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability apple-maps-local-business-search-via-x402atlas-63c537d7
```

Example prompt: Can you find the top ramen restaurants near downtown Seattle (47.6062, -122.3321) using Apple Maps and show me their ratings, hours, phone numbers, and websites?

## When to prefer this

Choose this endpoint when you specifically need Apple Maps data (muids for use with Apple Maps place details), or when you want Apple Maps' business coverage and ratings distinct from Google Maps. Prefer this over the Google Maps sibling when the downstream workflow uses Apple Maps place IDs, or when Apple Maps coverage is preferred for a region. Use the DuckDuckGo Maps sibling if you want combined Apple Maps + Tripadvisor data without specifying coordinates.

## Known failure modes

- Missing required 'q' parameter returns a 400 error
- Invalid center format (not lat,lng) may return no results or an error
- No results found for obscure queries in sparse areas returns empty results array
- Payment not processed (x402 protocol failure) blocks the response
- Apple Maps upstream outage causes 502 or timeout
- Query exceeding 400 characters is rejected

## How this service works

Apple Maps local business search — find places by query and map centre (latitude,longitude), returning ratings, reviews, address, phone, website & Apple Maps place ids (muid) as clean JSON.

## Output

Returns a JSON object with the search query, timestamp, and an array of place results. Each result includes the business title, Apple Maps muid (place ID), address, phone, website, rating, review count, max rating, open state, weekly hours, GPS coordinates (latitude/longitude), business type tags, and rank position in the result list.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 400,
       "description": "Apple Maps search query (business or category)"
      },
      "span": {
       "type": "string",
       "maxLength": 32,
       "description": "Optional viewport span as lat_span,lng_span (e.g. 0.05,0.05)"
      },
      "center": {
       "type": "string",
       "maxLength": 32,
       "description": "Optional viewport centre as latitude,longitude (e.g. 37.7749,-122.4194)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "queried_at",
      "results"
     ],
     "properties": {
      "query": {
       "type": "string"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "title"
        ],
        "properties": {
         "muid": {
          "type": "string",
          "description": "Apple's place id, pass to /places/apple/place"
         },
         "phone": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "types": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "rating": {
          "type": "number"
         },
         "address": {
          "type": "string"
         },
         "reviews": {
          "type": "integer"
         },
         "website": {
          "type": "string"
         },
         "place_id": {
          "type": "string"
         },
         "position": {
          "type": "integer",
          "description": "Rank in the result list"
         },
         "max_rating": {
          "type": "number"
         },
         "open_state": {
          "type": "string"
         },
         "weekly_hours": {
          "type": "object",
          "description": "Apple's openin
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "coffee",
  "results": [
   {
    "muid": "1234567890",
    "title": "Blue Bottle Coffee",
    "types": [
     "Coffee shop"
    ],
    "rating": 4.5,
    "address": "1 Ferry Building, San Francisco, CA",
    "reviews": 812,
    "position": 1
   }
  ],
  "queried_at": "2026-07-11T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apple-maps-local-business-search-via-x402atlas-63c537d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from places.use.x402atlas.com](https://www.zero.xyz/host/places.use.x402atlas.com/llms.txt)