McDonald's
McDonald's — the fast-food chain.
McDonald's — the fast-food chain. Restaurant locator, national menu by category, and one item's full nutrition detail are callable now; current public deals and McDelivery availability are still stubs.
Domain: mcdonalds.com
Also known as: McDonald's, McDonalds, McDonald's Corporation, mcdonalds.com
Call it directly
bowmark.providers.mcdonalds.getMenu({ category? }): Promise<mcdonaldsMenu>
bowmark.providers.mcdonalds.getMenuItem({ productId }): Promise<mcdonaldsMenuItemDetail>
bowmark.providers.mcdonalds.findStores({ zip } | { latitude, longitude }, { radiusMiles?, maxResults? }): Promise<mcdonaldsFindStoresResult>Functions
| Function | What it does |
|---|---|
getMenu | Returns McDonald's national menu — every item's internal id, name, the category it is listed under, its product-or-meal page link, and any promo badge the site shows (e.g. "Limited Time… |
getMenuItem | Returns one McDonald's menu item in full: its marketing name and description, FDA-style ingredient statement, allergen line, whether it's a multi-part meal (with a components breakdown),… |
findStores | Finds McDonald's restaurants near a location — pass EITHER a 5-digit US zip (geocoded to a centroid with a keyless third-party lookup, since mcdonalds.com's own search endpoint takes only… |
Types
interface mcdonaldsMenuItem {
productId: string;
name: string;
category: string;
url: string;
badge: string;
}
interface mcdonaldsMenu {
categories: string[];
items: mcdonaldsMenuItem[];
sourceUrl: string;
}
type mcdonaldsMenuCategory =
| "Extra Value Meals"
| "McValue®"
| "Breakfast"
| "Burgers"
| "Chicken & Fish Sandwiches"
| "McNuggets® & McCrispy® Strips"
| "Snack Wrap®"
| "Fries & Sides"
| "Happy Meal®"
| "Sweets & Treats"
| "McCafé®"
| "Drinks"
| "Sauces & Condiments";
interface mcdonaldsMenuItemNutrient {
name: string;
value: number | null;
unit: string;
dailyValuePercent: number | null;
isDisplayed: boolean;
}
interface mcdonaldsMenuItemComponent {
name: string;
servingSize: string;
}
interface mcdonaldsMenuItemDetail {
productId: string;
name: string;
slug: string;
tagline: string;
description: string;
ingredientStatement: string;
allergens: string;
hasComponents: boolean;
components: mcdonaldsMenuItemComponent[];
nutrition: mcdonaldsMenuItemNutrient[];
sourceUrl: string;
}
interface mcdonaldsStoreServices {
dineIn: boolean;
driveThru: boolean;
mcDelivery: boolean;
mobileOrderAndPay: boolean;
kioskAudioAccessible: boolean;
wifi: boolean;
giftCards: boolean;
}
interface mcdonaldsStoreHours {
today: string;
driveThruToday: string;
week: Record<"monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday", string>;
driveThruWeek: Record<"monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday", string>;
}
interface mcdonaldsDeliveryPartner {
identifier: string;
name: string;
url: string;
}
interface mcdonaldsStore {
id: string;
addressLine1: string;
city: string;
state: string;
zip: string;
country: string;
phone: string;
latitude: number;
longitude: number;
distanceMiles: number;
openStatus: string;
hours: mcdonaldsStoreHours;
services: mcdonaldsStoreServices;
amenities: string[];
deliveryPartners: mcdonaldsDeliveryPartner[];
}
interface mcdonaldsFindStoresResult {
stores: mcdonaldsStore[];
sourceUrl: string;
}