A101 Product Scraper

Collect structured product data from a101.com.tr, one of Turkey's largest discount retailers, across both the A101 Ekstra online range and the A101 Kapida doorstep range. Search by keyword or paste product and search URLs, and get back a clean record per product with prices, discounts, stock, images, categories, brands, campaigns and more.

Why this scraper

• 80+ fields per product covering identifiers, full pricing, stock rules, sales channels, origin, campaigns and media, far beyond a basic title and price.
• Optional detail-page enrichment: turn on fetchDetails to add each product's full description and its full specifications/attributes list (e.g. an appliance's power, capacity, dimensions and warranty) straight from its detail page. Billed as a detail-enrichment surcharge.
• Deals / specials views: scrape A101's Aldın Aldın promotional listings (weekly deals, plus Electronics and Home & Living) directly, in one click, or paste any promo listing URL.
• Was-price and savings on every discounted product: current price, original (was) price, discount amount, discount percentage and an is_on_special flag, all split into clean fields.
• Two catalogues in one actor: A101 Ekstra and A101 Kapida, selectable per search.
• Search and URL modes: build searches from keyword terms and filters, or paste a101.com.tr search, deals and product URLs.
• Price, brand and stock filters plus five sort orders, so you collect exactly the slice you want.
• Export to your apps through MCP connectors (Notion, Linear, Airtable, Apify).
• Clean Turkish lira pricing with normal price, discounted price and discount rate already separated.

Data you get

Sample shape - values are illustrative placeholders, not from a live listing.

Field	Example
product_id	00000000
barcode	0000000000000
title	Sample Coffee Beans 1000 G
brand	Sample Brand
category_path	Market > Beverages > Coffee
current_price	99.90
original_price	149.90
discounted_price	99.90
discount_rate	33
is_on_special	true
savings_amount	50.00
savings_percent	33
promo_label	%33 İNDİRİM
specials_category	aldin-aldin
pack_size	1000 g
currency	TRY
in_stock	true
channel_names	["A101 Online", "Magaza", "A101 Kapida"]
origin_country	Sample Country
min_quantity	1
max_quantity	5
return_days	15
vat_rate	1
variant_count	1
primary_image_url	https://cdn2.a101.com.tr/.../1.jpg
collections	[{"id": "S0000000", "name": "Sample Campaign"}]
promotions	[{"id": "promo-0", "name": "Sample Promotion"}]
badges	[{"id": "badge-0", "text": "Sample Badge"}]
url	https://www.a101.com.tr/.../sample_p-00000000

A101 does not publish customer reviews or star ratings on its product pages, so the rating and review_count fields are always empty. See "Reviews and ratings" below.

How to use

Search by keyword (A101 Ekstra):

{
  "mode": "search",
  "queries": ["kahve", "deterjan"],
  "channel": "ekstra",
  "maxListings": 100
}

Scrape a deals / specials view (Aldın Aldın):

{
  "mode": "search",
  "specialsCategory": "aldin-aldin",
  "maxListings": 200
}

The specials views are aldin-aldin (weekly deals), aldin-aldin-elektronik (electronics) and aldin-aldin-ev-yasam (home & living). Each discounted product carries original_price, savings_amount, savings_percent and promo_label alongside the current price. You can also add keyword queries to run them in the same run, or price/brand/stock filters and sorting to narrow the deals. To scrape any other promo or category listing, switch to URL mode and paste its page URL.

Search with filters and sorting:

{
  "mode": "search",
  "queries": ["kahve"],
  "minPrice": 50,
  "maxPrice": 500,
  "brand": "Tchibo",
  "inStockOnly": true,
  "sortBy": "price-asc",
  "maxListings": 50
}

Paste URLs (search or product pages):

{
  "mode": "url",
  "urls": [
    "https://www.a101.com.tr/arama?k=su",
    "https://www.a101.com.tr/market/sample-product_p-00000000"
  ],
  "maxListings": 40
}

With detail-page enrichment (full description + specifications):

{
  "mode": "search",
  "queries": ["espresso makinesi"],
  "fetchDetails": true,
  "maxListings": 20
}

Input parameters

Parameter	Type	Description
mode	select	search (keyword + filters) or url (paste a101.com.tr URLs). Required.
queries	array	Keyword terms to search. One search runs per term. Search mode only.
channel	select	Catalogue to search: ekstra (A101 Ekstra) or kapida (A101 Kapida). Search mode only.
minPrice	integer	Keep products with a current price at or above this value, in TRY. Search mode only.
maxPrice	integer	Keep products with a current price at or below this value, in TRY. Search mode only.
brand	string	Keep only products of this exact brand (case-insensitive). Search mode only.
inStockOnly	boolean	Drop out-of-stock products. Search mode only.
sortBy	select	relevance, price-asc, price-desc, discount-desc, name-asc. Search mode only.
specialsCategory	select	Optionally scrape an Aldın Aldın deals view: aldin-aldin, aldin-aldin-elektronik or aldin-aldin-ev-yasam. Empty for a normal keyword search. Search mode only.
urls	array	a101.com.tr search, deals or product URLs. URL mode only. Filter fields above are ignored in this mode.
maxPages	integer	Optional per-search page ceiling. Empty or 0 means no page limit; defers to Max products.
maxListings	integer	The single hard cap on total products collected. Default 20. Set 0 for unlimited.
fetchDetails	boolean	Adds the product's full description and full specifications/attributes list from its detail page, on top of the search card. Applies to every product this run collects, in both modes. Billed as a detail-enrichment surcharge. Default false.
proxy	object	Proxy configuration. The default Apify proxy works well.
mcpConnectors	array	Optional MCP connectors to also receive the results (Notion, Linear, Airtable, Apify).
notionParentPageUrl	string	Notion parent page URL or id, required only for the Notion connector.
maxNotifyListings	integer	Cap on items sent to each connector per run. Does not affect the dataset.

Output example

Sample shape - values are illustrative placeholders, not from a live listing.

{
  "product_id": "00000000",
  "base_id": "00000000",
  "barcode": "0000000000000",
  "title": "Sample Coffee Beans 1000 G",
  "seo_name": "Sample Coffee Beans 1000 G",
  "url": "https://www.a101.com.tr/market/sample-coffee-beans-1000-g_p-00000000",
  "country": "TR",
  "brand": "Sample Brand",
  "brand_url": "https://www.a101.com.tr/markalar/sample-brand",
  "category": "Coffee",
  "category_path": "Market > Beverages > Coffee",
  "currency": "TRY",
  "current_price": 99.90,
  "original_price": 149.90,
  "discounted_price": 99.90,
  "current_price_text": "TRY 99,00",
  "discount_rate": 33,
  "is_on_special": true,
  "savings_amount": 50.00,
  "savings_percent": 33,
  "promo_label": "%33 İNDİRİM",
  "specials_category": "aldin-aldin",
  "pack_size": "1000 g",
  "in_stock": true,
  "is_enabled": true,
  "min_quantity": 1,
  "max_quantity": 5,
  "return_days": 15,
  "vat_rate": 1,
  "channel_names": ["A101 Online", "Magaza", "A101 Kapida"],
  "origin_country": "Sample Country",
  "images": [{ "id": "1.jpg", "url": "https://cdn2.a101.com.tr/.../1.jpg", "type": "product" }],
  "primary_image_url": "https://cdn2.a101.com.tr/.../1.jpg",
  "image_count": 1,
  "collections": [{ "id": "S0000000", "name": "Sample Campaign" }],
  "variant_count": 1,
  "short_description": "Sample short description.",
  "description": "Kahve kaynağı: Taze kahve çekirdekleri\nBasınç: 15 bar\nGüç: 1500 W\n...",
  "specifications": { "Basınç": "15 bar", "Güç": "1500 W", "Garanti süresi": "2 yıl" },
  "rating": null,
  "review_count": null
}

description and specifications are only present when fetchDetails is on (see below); otherwise these keys are absent from the row entirely, matching the free path's existing output shape exactly.

Detail-page enrichment (fetchDetails)

Turn on fetchDetails to fetch each product's own detail page and merge in:

• specifications — the full attribute/spec table the detail page exposes for that product (key/value pairs — for example an appliance's power, capacity, dimensions, energy class and warranty; a grocery or apparel item may only expose its country of origin).
• description — the same detail-page content as readable text.

This is genuinely richer than the search/listing card, which never carries either field. How much extra content a given product has depends on the product: electronics and appliances typically expose dozens of attributes; simpler grocery and apparel items may expose only one or two. Only products whose detail page actually yields new content are enriched and billed — a fetch that fails (timeout, removed listing) is neither retried against a stale value nor charged. Billed as a detail-enrichment surcharge, once per product actually enriched; runs with fetchDetails off (the default) are never charged this event.

Reviews and ratings

A101 product pages do not include a customer reviews or star-rating feature. The catalogue exposes product, price, stock, campaign and media data only; there is no ratings summary, no individual reviews and no review count anywhere on the product pages or in the product data. The output keeps rating and review_count fields for a stable schema, but both are always empty. If A101 adds a reviews feature in the future, these fields are ready to carry it.

Send results into your apps (MCP connectors)

You can optionally pipe each run's results into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then list it in mcpConnectors. Each connector receives a condensed, human-readable summary per item (title plus key fields); the complete record always stays in the dataset. Supported connectors include Notion, Linear, Airtable and Apify. For the Notion connector, set notionParentPageUrl to the page under which item pages are created.

Plan requirement

This actor runs on any Apify account. Using the default Apify proxy is recommended for reliable, uninterrupted collection.