---
title: "Search Apple Maps places near a coordinate"
method: GET
path: "/apple-maps/search"
tags: ["Apple Maps"]
---

# Search Apple Maps places near a coordinate

`GET /apple-maps/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/apple-maps/search`
- Auth: API key in header `x-api-key`

Returns Apple Maps places matching a keyword, business name, category, or street address near a coordinate. Each place carries its Apple place ID (the value the place endpoint takes), name, category, coordinates, formatted and structured address, phone, website, rating and review count, price level, weekly opening hours, and a hero photo. Apple returns a bounded set per viewport (around 25 places for the default span) with no pagination; widen the span or move the center to cover more area. When nothing matches near the center Apple may relocate the search to a default region, reported by relocated=true and the region bounds. The response's filters block lists the refinement chips Apple offers for this query and area (open now, top rated, in guides, cuisines, price bands, amenities, accolades, sort); pass their keys back as filters and sort to refine the same search.

## Query parameters

- `query` string, required
- `latitude` number, required
- `longitude` number, required
- `span` number
- `limit` integer
- `lang` string
- `country` string
- `filters` string
- `sort` 'best_match' | 'distance' | 'ratings'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplemapsSearchResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` ApplemapsSearchResponse
    - `filters` ApplemapsFilterGroup[]
      - `match` string
      - `name` string
      - `options` ApplemapsFilterOption[]
        - `key` string
        - `name` string
        - `selected` boolean
      - `type` string
    - `guides` ApplemapsGuideSummary[]
      - `description` string
      - `id` string
      - `item_total` integer
      - `last_modified` string
      - `photo_url` string
      - `publisher` ApplemapsPublisherSummary
        - `guide_count` integer
        - `id` string
        - `name` string
        - `subtitle` string
        - `url` string
        - `website` string
      - `source_url` string
      - `title` string
      - `url` string
    - `places` ApplemapsPlace[]
      - `address` string
      - `address_info` ApplemapsAddress
        - `city` string
        - `country` string
        - `country_code` string
        - `county` string
        - `neighborhood` string
        - `postal_code` string
        - `state` string
        - `state_code` string
        - `street` string
      - `alt_phones` string[]
      - `categories` ApplemapsCategory[]
        - `id` string
        - `level` integer
        - `name` string
      - `category` string
      - `hours` ApplemapsDayHours[]
        - `close` string
        - `day` string
        - `open` string
      - `hours_type` string
      - `id` string
      - `latitude` number
      - `longitude` number
      - `name` string
      - `phone` string
      - `photo_url` string
      - `place_id` string
      - `price_level` integer
      - `price_max` integer
      - `price_symbol` string
      - `rating` number
      - `rating_count` integer
      - `rating_max` integer
      - `type` string
      - `url` string
      - `website` string
    - `query` string
    - `region` ApplemapsRegion
      - `east` number
      - `north` number
      - `south` number
      - `west` number
    - `relocated` boolean
    - `total_found` integer
    - `total_results` integer
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)