metro.de 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.
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'
Search for products in the Online-Marketplace (with delivery). Returns names, prices (net and gross), images, and product URLs.
| 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": 3636,
"products": [
{
"id": "8616fd3e-f30d-401f-afc2-917817ff91eb",
"name": "aro Kühlschrank DFZW1450E, PCM, 55 x 57 x 141 cm, 162 L, mit Gefrierfach (44 L), weiß",
"image_url": "https://images.metro-marketplace.eu/item_image/53de0d80-1b84-4d07-84e9-e0c28b30df02",
"price_net": "179,99 €",
"price_gross": "214,19 €",
"product_url": "https://www.metro.de/marktplatz/product/8616fd3e-f30d-401f-afc2-917817ff91eb",
"availability": "Delivery AVAILABLE",
"has_discount": false,
"discount_percentage": null
}
]
},
"status": "success"
}
}About the metro.de 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.
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.
- 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 | 250 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.