# Cimri Scraper - Turkish Price Comparison Data (`studio-amba/cimri-scraper`) Actor Scrape product prices and deals from Cimri.com, Turkey's leading price comparison site. Compare prices across hundreds of Turkish retailers. Extract product names, prices, merchant offers, ratings, and reviews. No login required. - **URL**: https://apify.com/studio-amba/cimri-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 60.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Cimri Scraper - Turkish Price Comparison Data Scrape product prices, merchant offers, and comparison data from [Cimri.com](https://www.cimri.com), Turkey's leading price comparison engine with 10M+ monthly visits and hundreds of retailers. No login or cookies required. Just provide a search query or category URL and get structured product data. ### How to scrape Cimri data 1. Go to [Cimri Scraper](https://apify.com/studio-amba/cimri-scraper) on Apify Store. 2. Click **Try for Free**. 3. Enter a search query (e.g., `telefon`, `laptop`, `televizyon`) or paste a Cimri category URL. 4. Click **Start** and wait for the run to finish. 5. Download your data in JSON, CSV, Excel, or connect via API. ### What data can you scrape from Cimri? This scraper extracts comprehensive price comparison data from Cimri.com: | Field | Description | |-------|-------------| | `productName` | Full product name | | `category` | Product category on Cimri | | `lowestPrice` | Lowest price across all merchants (TRY) | | `highestPrice` | Highest price across all merchants (TRY) | | `currency` | Currency code (TRY) | | `numberOfOffers` | How many merchants offer this product | | `brand` | Brand or manufacturer | | `imageUrl` | Product image URL | | `url` | Direct Cimri product page URL | | `merchants` | Array of merchant offers (name, price, URL) | | `rating` | Average product rating | | `reviewCount` | Number of user reviews | | `scrapedAt` | Timestamp of when the data was collected | ### Example output ```json { "productName": "Samsung Galaxy S24 Ultra 256 GB", "category": "Cep Telefonlari", "lowestPrice": 54999, "highestPrice": 68990, "currency": "TRY", "numberOfOffers": 12, "brand": "Samsung", "imageUrl": "https://cdn.cimri.com/image/800x800/samsung-galaxy-s24-ultra.jpg", "url": "https://www.cimri.com/cep-telefonlari/en-ucuz-samsung-galaxy-s24-ultra-256-gb-fiyatlari,123456789", "merchants": [ { "name": "Trendyol", "price": 54999, "url": "https://www.trendyol.com/..." }, { "name": "Hepsiburada", "price": 55490, "url": "https://www.hepsiburada.com/..." }, { "name": "N11", "price": 56250, "url": "https://www.n11.com/..." } ], "rating": 4.7, "reviewCount": 342, "scrapedAt": "2026-06-09T12:00:00.000Z" } ```` ### Input options | Parameter | Type | Description | |-----------|------|-------------| | `searchQuery` | string | Search term (e.g., `telefon`, `laptop`). Defaults to `telefon` if empty. | | `categoryUrl` | string | Optional Cimri category URL to scrape instead of searching. | | `maxResults` | integer | Maximum products to return. Default: 100. | | `proxyConfiguration` | object | Proxy settings. Residential TR proxies recommended. | ### Use cases - **Price monitoring** -- Track product prices across Turkish e-commerce stores over time. - **Competitor analysis** -- Compare your pricing against competitors on the Turkish market. - **Market research** -- Analyze product availability, pricing trends, and merchant coverage in Turkey. - **Product catalog building** -- Build comprehensive product databases with Turkish market pricing. - **Deal hunting** -- Find the lowest prices across hundreds of Turkish retailers automatically. ### Tips for best results - Use **Turkish search terms** for the best results (e.g., `cep telefonu` instead of `mobile phone`). - Use **residential proxies** with Turkey (TR) country code for reliable access. - Set `maxResults` to control how many products you need -- lower values run faster. - For specific categories, paste the Cimri category URL directly (e.g., `https://www.cimri.com/cep-telefonlari`). ### Supported categories Cimri covers all major product categories in Turkey: - Electronics (phones, laptops, TVs, tablets) - Home appliances (refrigerators, washing machines, vacuum cleaners) - Personal care and beauty - Sports and outdoor - Automotive - Baby and kids products - Fashion and accessories - Home and garden - And many more ### About Cimri.com Cimri is Turkey's second-largest price comparison website, founded in 2008 and acquired by iLab in 2011. The platform aggregates product listings from hundreds of Turkish online retailers including Trendyol, Hepsiburada, N11, Amazon Turkey, and many more. With over 10 million monthly visits, Cimri is a primary resource for Turkish consumers comparing prices before making purchase decisions. ### Integrations and API access This actor stores results in an Apify Dataset. You can access the data through: - **API** -- RESTful API with JSON, CSV, XML, and Excel export formats. - **Webhooks** -- Get notified when a scraping run finishes. - **Integrations** -- Connect to Google Sheets, Slack, Zapier, Make, and other platforms. - **Scheduled runs** -- Set up automatic recurring scrapes on any schedule. ### Is it legal to scrape Cimri? This actor scrapes only publicly available data from Cimri.com that any visitor can see without logging in. It does not bypass any authentication or access private user data. Always review Cimri's terms of service and ensure your use case complies with applicable laws and regulations. # Actor input Schema ## `searchQuery` (type: `string`): Search term to find products on Cimri (e.g., 'telefon', 'laptop', 'televizyon'). If empty, defaults to 'telefon'. ## `categoryUrl` (type: `string`): Optional: a Cimri category page URL to scrape instead of searching. Example: https://www.cimri.com/cep-telefonlari ## `maxResults` (type: `integer`): Maximum number of products to return. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies are recommended for best results with Cimri. ## Actor input object example ```json { "searchQuery": "telefon", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "TR" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "telefon", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "TR" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/cimri-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "telefon", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "TR", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/cimri-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "telefon", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "TR" } }' | apify call studio-amba/cimri-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/cimri-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cimri Scraper - Turkish Price Comparison Data", "description": "Scrape product prices and deals from Cimri.com, Turkey's leading price comparison site. Compare prices across hundreds of Turkish retailers. Extract product names, prices, merchant offers, ratings, and reviews. No login required.", "version": "0.1", "x-build-id": "HWSPvYAPtvM7B6mrk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~cimri-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-cimri-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/studio-amba~cimri-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-cimri-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/studio-amba~cimri-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-cimri-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search term to find products on Cimri (e.g., 'telefon', 'laptop', 'televizyon'). If empty, defaults to 'telefon'." }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "Optional: a Cimri category page URL to scrape instead of searching. Example: https://www.cimri.com/cep-telefonlari" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are recommended for best results with Cimri." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```