# McDonald's API: Search restaurants > Finds McDonald's restaurants within 50 miles of a US city, address or ZIP code, nearest first. Each result includes today's hours, services and directions. Open-now status follows the listed hours. Unofficial. Not affiliated with or endorsed by McDonald's. - Page: https://fous.com/methods/mcdonalds.com/search-restaurants - Method: `mcdonalds.com/search_restaurants`, version 1 - Website: mcdonalds.com - Returns: address, distance, phone, today's hours, drive-thru hours, open now, services, directions URL, page URL, store number, coordinates - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `location` | string | yes | `"Chicago, IL"` | US city, street address, or ZIP code, for example Chicago, IL. | | `max_results` | integer | no | `10` | Maximum restaurants to return, for example 10. Default 10. | | `open_now_only` | boolean | no | `false` | Only show restaurants open now, for example false. Default false. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "location": "Chicago, IL", "max_results": 10, "open_now_only": false } ``` Its output: ```json { "restaurants": [ { "address": "111 W Jackson, Chicago, IL 60604", "latitude": 41.877966, "open_now": false, "page_url": "https://www.mcdonalds.com/us/en-us/location/il/chicago/111-w-jackson/20104.html", "services": [ "Gift Cards", "Indoor Dining", "Accessible Kiosk" ], "longitude": -87.631736, "phone_number": "(312) 922-1648", "store_number": "20104", "directions_url": "https://www.google.com/maps/dir/?api=1&destination=41.877966%2C-87.631736&travelmode=driving", "distance_miles": 0.41, "todays_opening_hours": "5:00 AM – 8:00 PM", "todays_drive_thru_hours": "5:00 AM – 10:00 PM" }, { "address": "180 W Adams, Chicago, IL 60603-3602", "latitude": 41.879502, "open_now": false, "page_url": "https://www.mcdonalds.com/us/en-us/location/il/chicago/180-w-adams/4061.html", "services": [ "Gift Cards", "Indoor Dining", "Accessible Kiosk" ], "longitude": -87.633621, "phone_number": "(312) 580-0773", "store_number": "4061", "directions_url": "https://www.google.com/maps/dir/?api=1&destination=41.879502%2C-87.633621&travelmode=driving", "distance_miles": 0.55, "todays_opening_hours": "5:00 AM – 4:00 AM (next day)", "todays_drive_thru_hours": "5:00 AM – 4:00 AM (next day)" }, { "address": "203 N Lasalle St, Chicago, IL 60601", "latitude": 41.885816, "open_now": false, "page_url": "https://www.mcdonalds.com/us/en-us/location/il/chicago/203-n-lasalle-st/36148.html", "services": [ "Gift Cards", "Indoor Dining", "Accessible Kiosk" ], "longitude": -87.631667, "phone_number": "(312) 332-0482", "store_number": "36148", "directions_url": "https://www.google.com/maps/dir/?api=1&destination=41.885816%2C-87.631667&travelmode=driving", "distance_miles": 0.8, "todays_opening_hours": "5:30 AM – 11:00 PM", "todays_drive_thru_hours": "5:30 AM – 8:00 PM" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"mcdonalds.com/search_restaurants","input":{"location":"Chicago, IL","max_results":10,"open_now_only":false}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find the nearest McDonald's to 90210 with hours and drive-thru info - Which McDonald's near Austin, TX is open right now? - I need a list of 8 McDonald's within 50 miles of Denver, CO including phone numbers - Show McDonald's locations around the address 425 Market St, San Francisco with their services and directions - Are there any open McDonald's restaurants near ZIP 60601 at this moment? Show store numbers and coordinates ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "minLength": 1, "description": "US city, street address, or ZIP code, for example Chicago, IL." }, "max_results": { "type": "integer", "default": 10, "maximum": 30, "minimum": 1, "description": "Maximum restaurants to return, for example 10." }, "open_now_only": { "type": "boolean", "default": false, "description": "Only show restaurants open now, for example false." } } } ``` ## Output schema ```json { "type": "object", "required": [ "restaurants" ], "properties": { "restaurants": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string" }, "latitude": { "type": "number" }, "open_now": { "type": "boolean" }, "page_url": { "type": "string" }, "services": { "type": "array", "items": { "type": "string" } }, "longitude": { "type": "number" }, "phone_number": { "type": [ "string", "null" ] }, "store_number": { "type": [ "string", "null" ] }, "directions_url": { "type": "string" }, "distance_miles": { "type": "number" }, "todays_opening_hours": { "type": [ "string", "null" ] }, "todays_drive_thru_hours": { "type": [ "string", "null" ] } } } } } } ``` ## See more - [McDonald's API: Get menu item nutrition](https://fous.com/methods/mcdonalds.com/get-menu-item-nutrition.md): Looks up a McDonald's menu item by name on the US, UK or Canada site and returns its nutrition, allergens, ingredients and photo link. - [Starbucks API: Find nearby cafés](https://fous.com/methods/starbucks.com/search-stores.md): Finds Starbucks cafés near a city, address or ZIP code, nearest first, with whether each is open now, today's local hours and amenities; optionally only cafés open now. - [Chipotle API: Get nearest menu](https://fous.com/methods/chipotle.com/get-menu.md): Finds the nearest open Chipotle that takes online orders for a city, address, or ZIP code and returns its address, distance, today's hours and the pickup menu with prices, calories and photos. - [AutoZone API: Search stores near a location](https://fous.com/methods/autozone.com/search-stores.md): Finds the AutoZone stores nearest a US ZIP code, city or street address, with contact details, opening hours, whether each is open now, distance and store page links. - [DoorDash API: Search restaurants](https://fous.com/methods/doordash.com/search-restaurants.md): Finds DoorDash restaurants delivering to a street address or ZIP code, optionally for a cuisine or dish, in DoorDash's search order. Fees and times reflect guest offers; the numeric fee is null when DoorDash shows no amount. - [Google API: Get place](https://fous.com/methods/google.com/get-place.md): Looks up a public Google Maps place by name and location and returns its profile: address, rating, hours, phone, website and photos. - [Google API: Search places](https://fous.com/methods/google.com/search-places.md): Finds businesses and places near a location on Google Maps, in Google Maps order, with rating, hours, contact details and links when shown. - [Costco API: Find nearby warehouses](https://fous.com/methods/costco.com/search-warehouses.md): Finds the US Costco warehouses nearest a city, address or ZIP code, with today's and weekly hours, gas station hours, services and posted gas prices. - [All McDonald's methods](https://fous.com/methods/mcdonalds.com.md)