mcdonalds APImcdonalds.com ↗
Access McDonald's Canada full menu via API. Retrieve nutrition facts, allergens, ingredients, and item details for every menu item by category or item ID.
What is the mcdonalds API?
The McDonald's Canada Menu API covers 2 endpoints that return menu item data including nutrition facts, allergens, ingredients, and component-level detail. Use get_menu to browse all items with summary nutrition and category filtering, or call get_item_details with a specific numeric item ID to retrieve a full structured nutrition object, allergen breakdown, ingredient statements, and availability time.
curl -X GET 'https://api.parse.bot/scraper/bce67488-088f-4406-8479-7be16bad6801/get_menu?category=Beef' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace mcdonalds-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""McDonald's Canada Menu API — browse items, filter by category, get full nutrition details."""
from parse_apis.mcdonalds_menu_api import McDonalds, Category, ItemNotFound
client = McDonalds()
# List beef items using the Category enum
for item in client.menuitemsummaries.search(category=Category.BEEF, limit=3):
print(item.name, item.allergens)
# Drill into the first chicken item for full nutrition
summary = client.menuitemsummaries.search(category=Category.CHICKEN, limit=1).first()
if summary:
detail = summary.details()
print(detail.name, detail.allergen_summary)
for key, nutrient in detail.nutrition.items():
print(f" {nutrient.name}: {nutrient.value} {nutrient.unit}")
# Direct lookup by item_id with typed error handling
try:
hamburger = client.menuitems.get(item_id="200154")
print(hamburger.name, hamburger.ingredient_statement[:80])
for comp in hamburger.components:
print(f" Component: {comp.name}")
except ItemNotFound as exc:
print(f"Item not found: {exc.item_id}")
print("exercised: menuitemsummaries.search / summary.details / menuitems.get")
Retrieve all McDonald's Canada menu items with summary nutrition data, allergens, and image URLs. Supports optional category filtering via case-insensitive partial match. Returns the full item list when no filter is applied. Each item carries a compact nutrition block (string values like '240 Cals') suitable for quick scanning; use get_item_details for structured numeric nutrition with daily-value percentages.
| Param | Type | Description |
|---|---|---|
| category | string | Filter by category name. Case-insensitive partial match. Verified categories include: 'Beef', 'Breakfast', 'Chicken', 'Beverages', 'McCafé & Bakery', 'Happy Meal', 'Snacks & Sides', 'Sandwiches & Wraps'. Omitting returns all items across all categories. |
{
"type": "object",
"fields": {
"items": "array of item summary objects with item_id, name, description, category, slug, allergens, nutrition, and image_url",
"categories": "array of distinct category name strings present in results",
"total_items": "integer count of items returned"
}
}About the mcdonalds API
Menu Browsing with get_menu
The get_menu endpoint returns an array of menu items, each carrying item_id, name, description, category, slug, allergens, image_url, and a compact nutrition block. The optional category parameter accepts a case-insensitive partial string match, so filtering by 'Beef', 'Breakfast', 'Chicken', or other category names narrows results without requiring an exact match. The response also includes a categories array of distinct category names present in the results and a total_items count.
Item Detail with get_item_details
Pass a numeric item_id (obtained from get_menu) to get_item_details to get the full record for a single item. The nutrition field is a keyed object where each nutrient entry contains name, value, unit, and daily_value_percent, making it straightforward to display structured nutrition panels. The components array provides sub-item ingredient statements and per-component allergens — useful for items like sandwiches that have multiple distinct parts. The time_of_day field indicates breakfast-only or all-day availability where applicable.
Coverage and Scope
All data reflects the McDonald's Canada menu at mcdonalds.com/ca/en-ca. Categories verified in the endpoint include Beef, Breakfast, Chicken, and others present on the Canadian full-menu page. Both endpoints return allergen lists as arrays of individual allergen strings, suitable for filtering or display in nutrition-aware applications.
The mcdonalds API is a managed, monitored endpoint for mcdonalds.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mcdonalds.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official mcdonalds.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a nutrition tracker that pulls per-nutrient
valueanddaily_value_percentfor any McDonald's Canada menu item - Filter breakfast-eligible items using the
time_of_dayfield returned byget_item_details - Display allergen warnings by parsing the
allergensarray from either endpoint - Populate a category-based menu browser using the
categoriesresponse fromget_menuwith partial-match filtering - Render ingredient lists for individual sandwich components using the
components[].ingredient_statementfield - Cross-reference item
slugandimage_urlto build a visual menu gallery linked to full nutrition detail pages
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does McDonald's have an official public developer API?+
How does category filtering work in get_menu?+
category parameter uses a case-insensitive partial match against category names. Passing 'chick' would match categories like 'Chicken' or 'Chicken Sandwiches'. The response includes a categories array listing all distinct category names present in the filtered results alongside the item array.Does the API cover McDonald's menus outside of Canada?+
Are prices or item availability by location included in the response?+
time_of_day availability (e.g., breakfast vs. all-day). You can fork this API on Parse and revise it to add pricing fields if that data becomes accessible.What does the components field in get_item_details represent?+
components array breaks a menu item into its constituent parts — for example, the bun, patty, and sauce in a burger. Each component object includes a name, an ingredient_statement listing raw ingredients, and an optional allergens array specific to that component.