Metro APImetro.de ↗
Access Metro Germany's online marketplace and wholesale store via API. Search products, retrieve pricing, brand, seller info, and category hierarchies across both channels.
What is the Metro API?
The Metro.de API covers 5 endpoints that expose product data from both Metro Germany's online marketplace and its Großmarkt wholesale channel. You can search either channel with search_marketplace_products or search_grossmarkt_products, then drill into individual listings for net and gross pricing, brand, seller name, promotional flags, energy labels, volume pricing tiers, and full category hierarchies. Both search endpoints return pagination-ready result sets.
curl -X GET 'https://api.parse.bot/scraper/40fac2db-1a15-4d0e-b697-5546682420d4/search_marketplace_products?query=Teller' \ -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 metro-de-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.
from parse_apis.metro_de_api import Metro, MarketplaceProductSummary, MarketplaceProduct, GrossmarktProductSummary, GrossmarktProduct, MarketplaceCategory
metro = Metro()
# Search the online marketplace for plates
for product in metro.marketplaceproductsummaries.search(query="Teller"):
print(product.name, product.price_net, product.has_discount)
# Drill into full details for the first result
detail = product.details()
print(detail.brand, detail.price_net, detail.seller)
for spec in detail.specifications:
print(spec.label, spec.value, spec.unit)
for tier in detail.volume_prices:
print(tier.quantity, tier.net_price, tier.save_percentage)
break
# Fetch a marketplace product directly by UUID
product_detail = metro.marketplaceproducts.get(uuid="26c5f075-e08e-459c-946f-e7373f041b4d")
print(product_detail.name, product_detail.price_gross, product_detail.shipping_time)
# Search the wholesale store for butter
for item in metro.grossmarktproductsummaries.search(query="Butter", store_id="00611"):
print(item.name, item.brand, item.price, item.availability)
# Navigate to full product details
full = item.details(store_id="00611")
print(full.article_number, full.currency)
for cat in full.specifications:
print(cat.name, cat.id)
break
# Fetch a grossmarkt product directly
gp = metro.grossmarktproducts.get(id="BTY-X3141690032", store_id="00611")
print(gp.name, gp.brand, gp.price)
# Browse marketplace categories
for category in metro.marketplacecategories.list():
print(category.name, category.slug, category.status)
for child in category.children:
print(child.name, child.slug)
Search for products in the Metro.de Online-Marketplace (with delivery). Returns product names, prices (net and gross), images, discount info, and product URLs. Returns a single page of results per query. Each product carries a UUID suitable for fetching full details via the product detail endpoint.
| Param | Type | Description |
|---|---|---|
| query | string | Search keyword for finding products in the marketplace. |
{
"type": "object",
"fields": {
"total": "integer, total number of matching products",
"products": "array of product objects with id, name, price_net, price_gross, discount_percentage, has_discount, image_url, product_url, availability"
},
"sample": {
"data": {
"total": 10354,
"products": [
{
"id": "26c5f075-e08e-459c-946f-e7373f041b4d",
"name": "aro Teller flach, Porzellan, Ø 27 cm, weiß, 6 Stück",
"image_url": "https://images.metro-marketplace.eu/item_image/b74bc29a-09bf-432b-b1f7-dde1a8b16e5d",
"price_net": "9,33 €",
"price_gross": "11,10 €",
"product_url": "https://www.metro.de/marktplatz/product/26c5f075-e08e-459c-946f-e7373f041b4d",
"availability": "Delivery AVAILABLE",
"has_discount": true,
"discount_percentage": "18"
}
]
},
"status": "success"
}
}About the Metro API
What the API Covers
The API spans two distinct Metro Germany retail channels. The online marketplace (search_marketplace_products, get_marketplace_product_detail) handles products available for home or business delivery, returning price_net, price_gross, discount_percentage, has_discount, seller identity, brand, and an array of image URLs. The wholesale channel (search_grossmarkt_products, get_grossmarkt_product_detail) covers in-store Großmarkt stock, where pricing is net-only and availability is tied to a specific store via the store_id parameter (a five-digit string, zero-padded).
Product Detail Endpoints
get_marketplace_product_detail accepts a UUID from marketplace search results and returns a broad field set: id, mid (Metro's internal identifier), brand, seller, promotion flag, currency, full images array, and a categories array with both name and slug per level. get_grossmarkt_product_detail accepts a BTY-X format ID (e.g., BTY-X3141690032) and returns article_number, base_price (formatted string), an active promotions array, and a specifications field containing the category hierarchy with names, IDs, and depth levels.
Categories and Filtering
list_refrigeration_subcategories returns the full marketplace category tree, including each category's id, name, slug, image, status, and a children array for subcategories. This is useful for building navigation, seeding category-level searches, or validating slugs before querying. The search_grossmarkt_products endpoint supports page, rows, query, and store_id inputs, giving control over pagination and store-level scoping.
Data Shape Notes
Several fields in the wholesale endpoints are nullable — total, price, and base_price can all be null or omitted depending on store availability. Marketplace product detail includes a promotion boolean and separate volume pricing structure, which is distinct from the promo_price field returned in Großmarkt search results. Currency is always returned as a currency code string (EUR in practice) rather than embedded in price strings.
The Metro API is a managed, monitored endpoint for metro.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when metro.de 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 metro.de 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?+
- Monitor net and gross price changes on specific Metro marketplace products using
price_netandprice_grossfields - Compare promotional pricing across Großmarkt locations by querying
search_grossmarkt_productswith differentstore_idvalues - Build a product catalog synced to Metro's category tree using
list_refrigeration_subcategoriesslugs and IDs - Identify discounted marketplace listings by filtering on
has_discountanddiscount_percentagefrom search results - Enrich wholesale product records with
article_number,brand, and category hierarchy fromget_grossmarkt_product_detail - Track seller and brand presence on Metro's marketplace using the
sellerandbrandfields inget_marketplace_product_detail - Paginate large wholesale product searches using
pageandrowsinputs with total count from thetotalfield
| 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 Metro.de have an official developer API?+
What does `get_marketplace_product_detail` return that the search endpoint does not?+
get_marketplace_product_detail adds several fields absent from search results: brand, seller, mid (Metro internal ID), a full images array, energy label data, volume pricing tiers, and a structured categories array with slugs. The search endpoint returns only a subset sufficient for listing views — id, name, price_net, price_gross, image_url, and has_discount.Can I query Großmarkt availability across all Metro stores at once?+
search_grossmarkt_products and get_grossmarkt_product_detail both accept a store_id parameter for one store at a time. You would need to issue separate requests per store ID to compare availability across locations. You can fork this API on Parse and revise it to batch multi-store queries or add a dedicated multi-store comparison endpoint.Are customer reviews or ratings included in the product detail endpoints?+
get_marketplace_product_detail and get_grossmarkt_product_detail) cover pricing, brand, categories, images, and specifications but do not return review counts, star ratings, or review text. You can fork this API on Parse and revise it to add a review-fetching endpoint if that data is available on the source pages.What should I know about nullable fields in the wholesale endpoints?+
total, price, and base_price in the Großmarkt endpoints can all return null, typically when a product's price is not set for the queried store or when stock information is unavailable for that location. The promotions field also returns null rather than an empty array when no active promotions exist. Code defensively around these fields rather than assuming a value is always present.