---
title: "Get one Apple Guide with its places"
method: GET
path: "/apple-maps/guides/guide"
tags: ["Apple Maps"]
---

# Get one Apple Guide with its places

`GET /apple-maps/guides/guide`

## Request

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

Returns one Apple Guide (curated collection) by id: title, description, last-modified time, cover photos, source link, publisher, and every place in the guide with the publisher's blurb for it plus the place's Apple place ID, name, category, coordinates, address, phone, website, rating, price level, hours, and photo.

## Query parameters

- `guide_id` string, required
- `lang` string
- `country` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplemapsGuideResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` ApplemapsGuideResponse
    - `description` string
    - `id` string
    - `item_total` integer
    - `items` ApplemapsGuideItem[]
      - `description` string
      - `photo_url` string
      - `place` 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
    - `last_modified` string
    - `photo_url` string
    - `photos` ApplemapsPhoto[]
      - `category` string
      - `height` integer
      - `id` string
      - `url` string
      - `width` integer
    - `publisher` ApplemapsPublisherSummary
      - `guide_count` integer
      - `id` string
      - `name` string
      - `subtitle` string
      - `url` string
      - `website` string
    - `source_url` string
    - `title` string
    - `url` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)