Endpoint Playground
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.
14 Oct 2026: 10 restaurants; 14 fields had a value in every checked item.
Sample value profiles: city: WESTMINSTER (7), CITY OF WESTMINSTER (1), LAMBETH (1) and 1 more; name: “STRAND” and 9 other values; delivery_url: ubereats.com.
curl 'https://api.crawlora.net/api/v1/mcdonalds/restaurants?latitude=40.7128&longitude=-74.006&country=us' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| latitude | number | Yes | 40.7128 | Search center latitude |
| longitude | number | Yes | -74.006 | Search center longitude |
| radius | integer | No | Search radius in miles, 1-100 (default 20) | |
| max_results | integer | No | Maximum restaurants to return, 1-50 (default 10) | |
| country | string | No | us | Market to search (default us). One of us, gb, ca, au, de, ie, nz, ch, nl, se. |
{
"code": 200,
"msg": "OK",
"data": {
"restaurants": [
{
"store_id": "10528",
"name": "160 BROADWAY",
"address": "160 Broadway",
"city": "New York",
"state": "NY",
"postal_code": "10038",
"telephone": "(212) 385-2066",
"latitude": 40.709438,
"longitude": -74.010086,
"timezone": "(GMT-05:00) Eastern Time (US & Canada)",
"open_status": "OPEN",
"today_hours": "00:00 - 00:00",
"hours": [
{
"day_of_week": "Monday",
"hours": "00:00 - 00:00"
}
],
"facilities": [
"GIFTCARDS",
"MOBILEOFFERS"
]
}
],
"count": 1,
"source_url": "https://www.mcdonalds.com/googleappsv2/geolocation?method=searchLocation",
"fetched_at": "2026-08-31T05:10:00Z"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.