a101.com.tr APIa101.com.tr ↗
Access A101 Kapıda grocery and A101 Ekstra electronics product data via 5 endpoints. Search products, browse categories, and retrieve prices and stock.
curl -X GET 'https://api.parse.bot/scraper/01e0d684-e029-4758-9eb5-c6214e407387/search_kapida_products?query=ekmek' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for grocery products available for home delivery (A101 Kapıda). Returns paginated results with product details including price, availability, images, and promotions.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| limit | integer | Number of results per page |
| queryrequired | string | Search term in Turkish (e.g. 'süt', 'ekmek', 'peynir') |
| store_id | string | Store location ID |
{
"type": "object",
"fields": {
"res": "array of result groups containing total_item_count and page_content (product listings)",
"query": "object with query expansion and processing info",
"total_item_count": "integer total number of matching products"
},
"sample": {
"data": {
"res": [
{
"page_content": [
{
"id": "14000041",
"image": [
{
"id": "vOsfLrRtD1",
"url": "https://cdn2.a101.com.tr/dbmk89vnr/CALL/Image/get/vOsfLrRtD1_1024x1024.png",
"imageType": "product"
}
],
"price": 5,
"title": "Ekmek 200 G",
"category": "Ekmek",
"currency": "TL",
"available": true
}
],
"total_item_count": 39
}
],
"query": {
"q": "ekmek",
"org_query": "ekmek"
},
"total_item_count": 1
},
"status": "success"
}
}About the a101.com.tr API
The A101.com.tr API provides 5 endpoints to query products, prices, stock levels, and category trees across both of A101's Turkish retail platforms. Use search_kapida_products to find grocery items available for home delivery by Turkish search terms like 'süt' or 'ekmek', or use search_ekstra_products to retrieve electronics and appliance listings with brand, category, variants, and inventory status.
Grocery Delivery (A101 Kapıda)
The get_kapida_categories endpoint returns the full category hierarchy for A101 Kapıda, including top-level category objects with id, displayName, parentId, and nested items for subcategories. Those category IDs (e.g. C05 for dairy, C06 for snacks) feed directly into get_kapida_category_products, which returns subcategory groupings, each with a products array containing fields for id, images, attributes, price, and stock. An optional store_id parameter on both endpoints scopes results to a specific delivery store location.
Product Search and Detail
search_kapida_products accepts a required query string in Turkish, plus optional page, limit, and store_id parameters. Results are grouped under res, which contains total_item_count and page_content arrays, alongside a top-level query object that exposes query expansion and processing metadata. For retrieving price and stock for a known item, get_kapida_product_detail takes a sku (sourced from search or category results) and returns a product object with normal and discounted price values in both numeric and formatted string forms (normalStr, discountedStr), a stock level string, and a quantity integer.
Electronics & Marketplace (A101 Ekstra)
search_ekstra_products covers A101's non-grocery marketplace: electronics, appliances, and third-party seller items. It returns a res array of product objects with name, price, brand, category, images, inStock, and variants. The facet_fields array exposes available filter dimensions for the current query, and total_item_count gives the full result size. Pagination is controlled with page and limit parameters.
- Track discounted grocery prices across A101 Kapıda categories using
price.discountedandprice.normalfields - Build a Turkish grocery price comparison tool using
search_kapida_productswith multiple Turkish search terms - Monitor stock availability for specific grocery SKUs with
get_kapida_product_detailstock level and quantity fields - Catalog electronics listings from A101 Ekstra including brand, variants, and in-stock status for competitive intelligence
- Map the full A101 Kapıda category tree using
get_kapida_categoriesto build a structured product taxonomy - Alert on price changes for appliances or electronics by periodically querying
search_ekstra_productsfor target items - Aggregate product image URLs and attributes from
get_kapida_category_productsto populate a product database
| 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 A101 have an official public developer API?+
What does `get_kapida_product_detail` return beyond price?+
product object with four price fields (normal, normalStr, discounted, discountedStr), a stock level string describing availability, and a quantity integer. It does not return full product descriptions or images — those come from the category or search endpoints.Are product reviews or ratings available through this API?+
How does the `store_id` parameter affect results?+
store_id parameter on search_kapida_products, get_kapida_category_products, and get_kapida_product_detail scopes results to a specific A101 Kapıda delivery store location. Omitting it returns general availability data not tied to a particular store.Is it possible to filter Ekstra search results by brand or category?+
search_ekstra_products endpoint returns a facet_fields array alongside results, which lists the filter dimensions available for a given query. However, passing those facet values back as filter parameters is not currently supported by the endpoint. You can fork this API on Parse and revise it to add facet-filtering inputs.