---
title: "Find McDonald's restaurants near a location"
method: GET
path: "/mcdonalds/restaurants"
tags: ["McDonalds"]
---

# Find McDonald's restaurants near a location

`GET /mcdonalds/restaurants`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/mcdonalds/restaurants`
- Auth: API key in header `x-api-key`

Returns McDonald's restaurants near a latitude/longitude, in any of ten markets. Each restaurant carries its store id, name, street address, city, state, postal code, phone, coordinates, timezone, open status, today's dining and drive-thru hours, the full published week of hours, and McDonald's own amenity codes (for example DRIVETHRU, WIFI, MOBILEOFFERS, GIFTCARDS). A delivery deep link is included where McDonald's publishes one; note it points at a third-party delivery platform. A coordinate with no McDonald's nearby returns an empty list rather than an error. Set country to search outside the United States -- the locator covers more markets than the menu and item endpoints do, so a country valid here is not necessarily valid there.

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `radius` integer
- `max_results` integer
- `country` 'us' | 'gb' | 'ca' | 'au' | 'de' | 'ie' | 'nz' | 'ch' | 'nl' | 'se'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- McdonaldsRestaurantsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` McdonaldsRestaurantsResponse
    - `count` integer
    - `country` string: Country echoes the market searched, so a response is self-describing when several markets are queried in one workflow.
    - `fetched_at` string
    - `restaurants` McdonaldsRestaurant[]
      - `address` string
      - `city` string
      - `delivery_url` string: DeliveryURL is the store's delivery deep link when one is published. Note McDonald's points this at a third-party delivery platform.
      - `drive_thru_hours` string
      - `facilities` string[]: Facilities are McDonald's own amenity codes for the restaurant (e.g. GIFTCARDS, MOBILEOFFERS, DRIVETHRU, WIFI).
      - `hours` McdonaldsRestaurantHours[]: Hours is the full week where McDonald's publishes it.
        - `day_of_week` string
        - `hours` string
      - `latitude` number
      - `longitude` number
      - `name` string
      - `open_status` string
      - `postal_code` string
      - `state` string
      - `store_id` string
      - `telephone` string
      - `timezone` string
      - `today_hours` string: TodayHours and DriveThruHours are the published windows for today.
    - `source_url` string
  - `msg` unknown

## Other responses

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