Max Burgers APIorder.maxburgers.com ↗
Access Max Burgers restaurants, menus, and cart sessions across Sweden, Denmark, Norway, and Poland via a structured REST API with 8 endpoints.
What is the Max Burgers API?
The Max Burgers API exposes 8 endpoints covering store locations, full menus, product details, and live cart sessions across Max Burgers' four operating markets: Sweden, Denmark, Norway, and Poland. Starting with get_stores, you can retrieve every restaurant's coordinates, opening hours, and timezone, then drill into per-store menus with get_menu to pull category trees, product pricing, and currency information localized to any supported culture code.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/66798bf8-1c8f-4e81-b7fa-1041245ec549/get_countries' \ -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 order-maxburgers-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.
"""Walkthrough: Max Burgers SDK — browse stores, products, and manage orders."""
from parse_apis.max_burgers_api import MaxBurgers, CountryCode, MenuType, CultureCode, ResourceNotFound
client = MaxBurgers()
# List Swedish stores with their locations
for store in client.stores.list(country_code=CountryCode.SE, limit=3):
print(store.name, store.city, store.postal_code)
# Get products for the first store
product = client.products.list(store_id="208", menu_type=MenuType.TAKEAWAY, limit=1).first()
if product:
print(product.title, product.price)
# Drill into product details to see modifier groups
detail = product.details(store_id="208", menu_type=MenuType.TAKEAWAY)
for group in detail.modifier_groups:
for item in group.items:
print(item.title, item.price)
# Create an order and add a product
order = client.orders.create(store_id="208", menu_type=MenuType.TAKEAWAY, country_code=CountryCode.SE)
print(order.order_id, order.currency_iso_code)
# Add product to the order
updated = order.add_product(product_id="14534", quantity=1)
print(updated.product_count, updated.menu_type)
# Retrieve current cart state with typed error handling
try:
refreshed = updated.get()
for item in refreshed.order_items:
print(item.title, item.quantity, item.menu_item_id)
except ResourceNotFound as exc:
print(f"Order not found: {exc}")
print("exercised: stores.list / products.list / product.details / orders.create / order.add_product / order.get")
Get list of supported country codes for the Max Burgers ordering system. Returns the four countries where Max Burgers operates: Sweden (se), Denmark (dk), Norway (no), and Poland (pl).
No input parameters required.
{
"type": "object",
"fields": {
"countries": "array of country code strings"
},
"sample": {
"data": {
"countries": [
"se",
"dk",
"no",
"pl"
]
},
"status": "success"
}
}About the Max Burgers API
Store and Location Data
get_stores accepts a country_code (se, dk, no, or pl) and a culture_code (e.g. sv-se, en-us) and returns a full list of Max Burgers locations in a single response. Each store object includes Id, Name, City, Street, PostalCode, Latitude, Longitude, and TzdbTimeZoneId. The get_countries endpoint returns the four supported country codes if you need to enumerate them programmatically before making a store request.
Menu and Product Data
get_menu takes a store_id, an optional menu_type (takeaway, eatin, or delivery), and optional locale params to return the complete menu for that store. The response includes a Refs object keyed by product ID — each entry carries Title, Price, Description, and Images — plus a Categories array with SubCategoryIds and ParentCategoryIds for building a category hierarchy, and a Currency object with CurrencyIsoCode, CurrencyName, and CurrencySymbol.
get_products wraps the same menu data into a flat products array with enriched fields: Title, Price, Description, ShortDescription, and a Configurables tree. For a single item, get_product_details adds ModifierGroupsDetails — an array of modifier groups each containing an Items array with Id, Title, and Price, covering add-ons, removals, and bread choices.
Cart and Order Management
create_order opens a cart session for a given store and returns an orderId along with storeId, menuType, and currencyIsoCode. Pass that orderId to add_to_cart with a product_id, a quantity, and an optional modifiers JSON array matching the product's Configurables structure. The response returns the full updated order state including orderItems (each with id, title, quantity, menuItemId) and a receiptData object with receiptLines, itemsTotal, and total. get_cart retrieves the current order state at any point using just the order_id.
The Max Burgers API is a managed, monitored endpoint for order.maxburgers.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when order.maxburgers.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 order.maxburgers.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 store locator that maps Max Burgers restaurants by city using Latitude, Longitude, and City fields from get_stores.
- Compare menu pricing across Sweden, Denmark, Norway, and Poland by calling get_menu with each country_code and reading the Currency and Refs data.
- Display a structured menu category tree for a kiosk UI using Categories with SubCategoryIds and ParentCategoryIds from get_menu.
- Show full burger customization options in an ordering app using ModifierGroupsDetails from get_product_details.
- Prototype a food ordering flow by chaining create_order, add_to_cart, and get_cart to manage a live cart session.
- Track product availability and pricing changes over time by polling get_products for a specific store_id.
- Filter menu items by order type (takeaway, eatin, delivery) using the menu_type parameter across get_menu and get_products.
| 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.