migros.com.tr APImigros.com.tr ↗
Access Migros supermarket product data via API: search products, browse categories, get pricing, discounts, and active campaigns from Migros.com.tr.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/25cf60c8-3706-4035-b4e7-6cb4742a8f70/get_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full category tree of the Migros supermarket. Returns a nested list of categories with their metadata and child categories.
No input parameters required.
{
"type": "array",
"fields": {
"data": "object containing category metadata (id, name, prettyName, images, depth, parentId, color)",
"children": "array of nested child category objects with the same structure"
},
"sample": {
"data": [
{
"data": {
"id": 20000000072311,
"name": "Tüm İndirimli Ürünler",
"color": "#FFE8E1",
"depth": 1,
"images": [
{
"urls": {
"x1": "https://images.migrosone.com/sanalmarket/category/list/72311/indirim-f3a481.png"
},
"sponsored": false
}
],
"parentId": 20000000000000,
"topLevel": true,
"prettyName": "tum-indirimli-urunler-dt-0",
"specialCategory": true
},
"children": []
}
],
"status": "success"
}
}About the migros.com.tr API
The Migros.com.tr API provides 6 endpoints covering the full Migros online supermarket catalog, including product search, category browsing, and promotional campaigns. The get_product_detail endpoint returns extended fields such as nutritional badges, HTML descriptions, availability status, and image sets keyed by size. Together, the endpoints let you retrieve category trees, paginate through product listings, and track active discounts in real time.
Category and Product Browsing
The get_categories endpoint returns the complete Migros category tree as a nested structure. Each node includes fields like id, name, prettyName, depth, parentId, color, and images. The prettyName slug (e.g. meyve-sebze-c-2) is the required category_slug input for get_products_by_category, which returns paginated product arrays with fields including regular_price, shown_price, discount_rate, brand, and unit.
Product Search and Detail
search_products accepts a query string (e.g. sut for milk products) and an optional page integer, and returns matching products alongside total_count and page_count for pagination. To go deeper on any item, pass its sku to get_product_detail, which extends the standard listing fields with an HTML description, badges, a status string such as IN_SALE, and an images object mapping multiple size keys to URLs.
Discounts and Campaigns
get_discounted_products provides a paginated feed of all products currently on promotion, including their discount_rate and both regular_price and shown_price so you can calculate savings directly. get_campaigns returns the active campaign list with each campaign's name, description, prettyName slug, imageUrls, and finishDate as a Unix timestamp in milliseconds — useful for filtering campaigns that are about to expire.
- Build a grocery price tracker that monitors
regular_pricevsshown_priceacross product SKUs over time. - Aggregate all discounted items via
get_discounted_productsto surface the highestdiscount_ratedeals in a deals newsletter. - Sync the full Migros category tree using
get_categoriesto power a faceted product search interface. - Monitor
get_campaignsfor upcomingfinishDatevalues to alert users before a promotion ends. - Compare brand presence within a category by paginating
get_products_by_categoryand grouping results by thebrandfield. - Check product availability by querying
get_product_detailfor thestatusfield before placing an order in an automated purchasing workflow. - Build a nutritional database by collecting the
descriptionandbadgesfields fromget_product_detailacross food category SKUs.
| 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 Migros.com.tr have an official public developer API?+
What does `get_product_detail` return beyond what search results provide?+
get_product_detail adds several fields not present in listing endpoints: an HTML description, a badges array (e.g. organic or dietary labels), a status string indicating availability such as IN_SALE, and an images object with multiple size-keyed URLs. The listing endpoints (search_products, get_products_by_category) return the core pricing and identification fields but omit these extended attributes.Does the API expose customer reviews or ratings for products?+
How does pagination work across the product listing endpoints?+
search_products, get_products_by_category, and get_discounted_products endpoints all accept an optional page integer (1-indexed) and return current_page, page_count, and total_count in every response. You can walk all pages by incrementing page until it equals page_count.Is stock level or warehouse inventory data available through this API?+
status string in get_product_detail (e.g. IN_SALE), which indicates general availability but does not include quantity, stock counts, or store-level inventory. You can fork the API on Parse and revise it to add granular inventory data if that endpoint is identified.