McDonalds

Find McDonald's restaurants near a location

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.

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

Query parameters

latitudenumber required

Search center latitude

longitudenumber required

Search center longitude

radiusinteger

Search radius in miles, 1-100 (default 20)

max_resultsinteger

Maximum restaurants to return, 1-50 (default 10)

country'us' | 'gb' | 'ca' | 'au' | 'de' | 'ie' | 'nz' | 'ch' | 'nl' | 'se'

Market to search (default us). One of us, gb, ca, au, de, ie, nz, ch, nl, se.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "count": 5,
    "country": "us",
    "restaurants": [
      {
        "address": "160 Broadway",
        "city": "New York",
        "hours": [
          {
            "day_of_week": "monday",
            "hours": "00:00 - 00:00"
          }
        ],
        "latitude": 40.709438,
        "longitude": -74.010086,
        "name": "160 BROADWAY",
        "open_status": "OPEN",
        "postal_code": "10038",
        "state": "NY",
        "store_id": "10528",
        "telephone": "(212) 385-2066"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.