---
title: "Get full detail for up to 20 Apple Maps places in one call"
method: GET
path: "/apple-maps/places"
tags: ["Apple Maps"]
---

# Get full detail for up to 20 Apple Maps places in one call

`GET /apple-maps/places`

## Request

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

Returns the same full detail as the place endpoint for up to 20 place IDs in a single upstream call, plus the list of requested IDs Apple did not return. Accepts the external I... form and the numeric id interchangeably.

## Query parameters

- `place_ids` string, required
- `lang` string
- `country` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplemapsPlacesResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` ApplemapsPlacesResponse
    - `not_found` string[]
    - `places` ApplemapsPlaceResponse[]
      - `about` string
      - `accolades` ApplemapsAccolade[]
        - `source` string
        - `text` string
        - `vendor` string
      - `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[]
      - `amenities` ApplemapsAmenity[]
        - `id` string
        - `name` string
        - `present` boolean
      - `categories` ApplemapsCategory[]
        - `id` string
        - `level` integer
        - `name` string
      - `category` string
      - `claim_url` string
      - `closed_since` string
      - `container_place_id` string
      - `cover_photo_url` string
      - `editorial` ApplemapsEditorial[]
        - `source` string
        - `text` string
        - `url` string
      - `ev_charging` ApplemapsEVCharging
        - `available` integer
        - `plugs` ApplemapsEVPlug[]
          - `available` integer
          - `connector` string
          - `connector_type` string
          - `power_kw` number
          - `speed` string
          - `status` string
          - `total` integer
        - `status` string
        - `total` integer
      - `facts` ApplemapsFact[]
        - `title` string
        - `type` string
        - `unit` string
        - `value` number
      - `guide_ids` string[]
      - `hours` ApplemapsDayHours[]
        - `close` string
        - `day` string
        - `open` string
      - `hours_type` string
      - `id` string
      - `latitude` number
      - `links` ApplemapsLink[]
        - `source` string
        - `title` string
        - `type` string
        - `url` string
      - `longitude` number
      - `name` string
      - `neighborhoods` string[]
      - `parent_place` ApplemapsPlaceRef
        - `id` string
        - `name` string
      - `phone` string
      - `photo_url` string
      - `photos` ApplemapsPhoto[]
        - `category` string
        - `height` integer
        - `id` string
        - `url` string
        - `width` integer
      - `place_id` string
      - `price_level` integer
      - `price_max` integer
      - `price_symbol` string
      - `rating` number
      - `rating_count` integer
      - `rating_max` integer
      - `related_place_ids` string[]
      - `reviews` ApplemapsReview[]
        - `id` string
        - `rating` number
        - `rating_max` integer
        - `source_url` string
        - `text` string
        - `time` string
      - `service_hours` ApplemapsServiceHours[]
        - `hours` ApplemapsDayHours[]
          - `close` string
          - `day` string
          - `open` string
        - `hours_type` string
        - `name` string
      - `summary_line` string
      - `timezone` string
      - `trailheads` ApplemapsTrailhead[]
        - `category` string
        - `id` string
        - `latitude` number
        - `longitude` number
        - `name` string
        - `photo_url` string
      - `transit` ApplemapsTransitInfo
        - `departures` ApplemapsTransitDeparture[]
          - `direction` string
          - `headsign` string
          - `line` string
          - `line_id` string
          - `live` string
          - `origin` string
          - `scheduled` string
          - `status` string
          - `stop_id` string
        - `lines` ApplemapsTransitLine[]
          - `color` string
          - `id` string
          - `name` string
          - `shield` string
          - `system` string
          - `type` integer
        - `stop_name` string
        - `systems` ApplemapsTransitSystem[]
          - `id` string
          - `name` string
        - `ttl_seconds` integer
      - `type` string
      - `url` string
      - `venue` ApplemapsVenue
        - `id` string
        - `levels` ApplemapsVenueLevel[]
          - `id` string
          - `name` string
          - `ordinal` integer
          - `short_name` string
        - `name` string
      - `venue_directory` ApplemapsVenueDirectory[]
        - `key` string
        - `name` string
        - `subcategories` ApplemapsVenueDirectoryEntry[]
          - `key` string
          - `name` string
      - `website` string
  - `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/afac9b012a27?raw)