# Citilink Scraper - Russian Electronics Store Products (`crawlerbros/citilink-scraper`) Actor Scrape Citilink.ru, one of Russia's largest electronics and appliance retailers. Search products by keyword, browse any category, or fetch full product details - pricing, ratings, specifications, images, and stock status. - **URL**: https://apify.com/crawlerbros/citilink-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ## Citilink Scraper Scrape **[Citilink.ru](https://www.citilink.ru)**, one of Russia's largest electronics, computer, and home-appliance retailers. Search products by keyword, browse any catalog category, pull full specifications for individual products, or fetch full-text customer reviews — no login, cookies, or API key required. ### What this actor does - **Search** — run a free-text keyword search (e.g. `iphone`, `ноутбук`, `телевизор`) and get back matching products with price, rating, and availability. - **Browse a category** — pull every product listed under any Citilink catalog category (smartphones, laptops, TVs, appliances, etc.) by slug or URL. - **Product details** — fetch full specifications, description, price, color variants, variant axes (colour/storage/etc.), and images for one or more products by ID or URL. - **Reviews** — fetch full-text customer reviews (title, body, view count, likes/dislikes) for one or more products by ID or URL — distinct from the star-rating opinion summary already included in product details. - **Empty fields are omitted** from every record — a field only appears when Citilink actually supplied a value for it. ### Output: per-product (search / byCategory) - `id` — Citilink product ID - `name`, `shortName` — Product title - `slug` — Citilink's URL slug for the product - `productUrl` — Canonical product page URL - `isAvailable` — Whether the product is currently purchasable - `priceCurrent`, `priceOld`, `discountPercent`, `bonusPoints` — Pricing (RUB) - `categoryId`, `categoryName` — Catalog category - `brand` — Brand name - `rating`, `opinionsCount`, `reviewsCount` — Customer feedback - `properties` — Key specs shown on the listing card (name/value pairs) - `images`, `imageUrl` — Product photo URLs - `multiplicity` — Minimum purchasable quantity increment, when above 1 - `accessMode` — Citilink's own visibility/sale mode for the listing - `earliestDeliveryDate` — Earliest self-pickup/delivery date, if available - `labels` — Promotional badges (installment plans, bundles, etc.) - `sourceUrl`, `scrapedAt`, `recordType` — Standard metadata ### Output: per-product (productDetails) All of the fields above, plus: - `originalProductId` — Citilink's underlying product ID (differs from `id` for some listings) - `description` — Full product description (plain text) - `properties` — Full specification list, each with an optional `measure` (unit) - `categorySlug`, `categoryPath` — Category slug and full breadcrumb (root → leaf) - `brandId`, `brandName` — Brand ID and name - `vendorCode` — Manufacturer/vendor code - `accessoriesCount`, `discussionsCount`, `documentationsCount`, `servicesCount`, `videosCount` — Per-section content counters - `colorVariants` — Sibling products in other colors, each with its own `id`, `productUrl`, `color`, `isAvailable`, and `imageUrl` - `variantGroups` — Every variant axis the product exposes (colour, storage, etc.), each with its sibling-product options — not just colour Product details also opportunistically include the following, when Citilink's own page loads them in time: - `ratingBreakdown` — Star-by-star opinion histogram: `[{stars, count, percentage}, ...]` - `topReview` — Citilink's own featured customer opinion — `text`, `pros`, `cons`, `rating`, `date`, `authorNickname`, `verifiedPurchase`, `likes`, `dislikes` - `relatedProducts` — "Bought together" complementary products (same fields as search results) - `similarProducts` — "Similar products" alternatives (same fields as search results) - `courierDelivery` — Fastest courier option — `price` (RUB), `eta`, `type` - `pickupStoresAvailable` — Number of pickup points with stock on the earliest available day ### Output: per-review (mode = `reviews`) - `productId` — Citilink product ID the review belongs to - `reviewId` — Citilink's own review ID - `title` — Review headline - `content` — Full review body (plain text/markdown as authored, including any embedded image links) - `viewsCount` — Number of times the review has been viewed - `createdAt`, `modifiedAt` — Timestamps (`modifiedAt` only present when it differs from `createdAt`) - `authorSuid` — Author's public site ID - `authorNickname` — Author's display nickname, if set - `likes`, `dislikes` — Helpful-vote counts (only present when non-zero) - `sourceUrl`, `scrapedAt`, `recordType` — Standard metadata ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `byCategory` / `productDetails` / `reviews` | | `searchQuery` | string | `iphone` | Free-text keyword (mode=search) | | `category` | string | – | Category slug (`smartfony`), catalog path, or full URL (mode=byCategory) | | `productIds` | array | `[]` | Product IDs or full product URLs (mode=productDetails, reviews) | | `maxReviewsPerProduct` | int | `20` | Cap on reviews fetched per product ID (1-200, mode=reviews) | | `sortBy` | string | `relevance` | `relevance` / `priceAsc` / `priceDesc` / `discount` / `rating` / `opinions` / `reviews` (mode=search, byCategory) | | `minPrice` | int | – | Drop products cheaper than this, RUB (mode=search, byCategory) | | `maxPrice` | int | – | Drop products more expensive than this, RUB (mode=search, byCategory) | | `minRating` | number | – | Drop products rated below this, 0-5 scale (mode=search, byCategory) | | `inStockOnly` | boolean | `false` | Only return purchasable products (mode=search, byCategory) | | `maxItems` | int | `10` | Hard cap on emitted records (1-500) | | `proxyConfiguration` | object | AUTO group | Apify proxy — required; the default AUTO (datacenter) group is sufficient | #### How sorting works When `sortBy=relevance` (the default), results are returned in Citilink's own order. For any other `sortBy` value, the actor gathers a wider window of results in relevance order, sorts that window by the requested key, then truncates to `maxItems`. This means non-relevance sorts reorder the *fetched* window rather than Citilink's entire catalog — for the most accurate top-N on a very broad category, narrow the search with a keyword or price filter first. ### Example: search with price and rating filters ```json { "mode": "search", "searchQuery": "ноутбук", "minPrice": 30000, "maxPrice": 100000, "minRating": 4, "sortBy": "priceAsc", "maxItems": 50 } ``` ### Example: browse a category in stock only ```json { "mode": "byCategory", "category": "smartfony", "inStockOnly": true, "sortBy": "discount", "maxItems": 100 } ``` ### Example: fetch full product details ```json { "mode": "productDetails", "productIds": [ "2143346", "https://www.citilink.ru/product/televizor-samsung-qe65q80dauxru-65-4k-ultra-hd-3840x2160-2135640/" ], "maxItems": 10 } ``` ### Example: fetch customer reviews ```json { "mode": "reviews", "productIds": ["2143346"], "maxReviewsPerProduct": 50 } ``` ### Use cases - Track pricing and discounts on specific product categories (e.g. all `smartfony` under 50,000 RUB). - Monitor stock availability for a watchlist of products by ID. - Build a price-comparison feed of Citilink search results for a set of keywords. - Pull full specifications for a batch of products to enrich your own catalog. - Analyze full-text customer reviews for a set of products (sentiment, common complaints, helpful-vote counts) beyond the star-rating summary. ### Other Russian marketplace actors by CrawlerBros | Actor | URL | |---|---| | Citilink Scraper - Russian Electronics Store Products (this actor) | | | DNS-Shop Scraper | | | Eldorado Scraper | | | ETM Electrical Equipment Scraper | | | Holodilnik.ru Scraper | | | Lemanapro Scraper | | | Magnit Market (mm.ru) Scraper | | | Maxidom Scraper | | | Megamarket.ru Scraper | | | M.Video Scraper | | | Onlinetrade.ru Scraper | | | Ozon Scraper - Products, Categories & Search | | | Petrovich Building Materials Scraper | | | Regard Scraper | | | Russkiy Svet (rs24.ru) Electrical Equipment Scraper | | | Technopark.ru Scraper - Products, Categories & Search | | | VseInstrumenti.ru Scraper | | | Wildberries Scraper | | | X-Com Shop Scraper | | | Yandex Market Pro Scraper | | ### FAQ **Do I need a Citilink account or API key?** No. The actor scrapes publicly available product data with no authentication. **Why does this actor require a proxy?** Citilink blocks automated requests without a working proxy session. The default AUTO (datacenter) proxy group is sufficient — residential proxy is not required. **Why is `sortBy` not a perfect global sort?** See "How sorting works" above — it's applied across the fetched result window, not Citilink's full catalog, to keep run times predictable. **Can I search in Russian?** Yes — `searchQuery` and `category` both accept Cyrillic text/slugs directly. **Why do some listing records have fewer specs than product-detail records?** Search/category results include only the handful of "short" specs Citilink shows on the listing card. Use `mode=productDetails` for the full specification list. **What's the difference between `topReview`/`ratingBreakdown` and `mode=reviews`?** `topReview` and `ratingBreakdown` (in `mode=productDetails`) summarize the star-rating "opinions" customers leave when rating a product. `mode=reviews` fetches Citilink's separate, longer-form written reviews (with a title and full body text) — a smaller, distinct pool of content some products don't have at all. **Why don't `ratingBreakdown`, `topReview`, `relatedProducts`, `similarProducts`, or `courierDelivery` appear on every product?** These sections load on the product page after the core content, and Citilink doesn't always render them in time. When that happens the core record (name, price, specs, images, etc.) is still returned in full — only the enrichment fields are omitted, never filled with placeholder data. **Why don't `productUrl` links open with a plain script or `curl` request?** Citilink's product and category pages require a real browser session to load; a script-only request without a browser is blocked. The URLs themselves are correct and open normally in any browser. Product image URLs (`cdn.citilink.ru/...`) are on a separate, unprotected host and load directly anywhere. **Is this actor affiliated with Citilink?** No, this is a third-party actor that reads publicly available data from citilink.ru. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchQuery` (type: `string`): Free-text keyword search (mode=search). Example: `iphone`, `ноутбук`, `телевизор`. ## `category` (type: `string`): A Citilink category slug (e.g. `smartfony`), a catalog path (`/catalog/smartfony/`), or a full category URL (`https://www.citilink.ru/catalog/smartfony/`). Find slugs by browsing citilink.ru/catalog/. ## `productIds` (type: `array`): Citilink product IDs (e.g. `2143346`) or full product URLs (e.g. `https://www.citilink.ru/product/smartfon-apple-iphone-17-a3520-256gb-purpurnyi-3g-4g-1sim-6-3-1206x262-2143346/`). ## `maxReviewsPerProduct` (type: `integer`): Cap on full-text customer reviews fetched per product ID (mode=reviews). Distinct from the star-rating opinion summary already included in mode=productDetails. ## `sortBy` (type: `string`): How to order results before truncating to Max items. Applied by the actor across the fetched result window (search/byCategory modes only) — see README for details. ## `minPrice` (type: `integer`): Drop products cheaper than this (Russian rubles). ## `maxPrice` (type: `integer`): Drop products more expensive than this (Russian rubles). ## `minRating` (type: `number`): Drop products rated below this (0-5 scale). ## `inStockOnly` (type: `boolean`): Only emit products currently available for purchase. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## `proxyConfiguration` (type: `object`): Citilink is protected by the QRATOR anti-bot service, which requires a real browser session. The default AUTO (datacenter) proxy group works for this challenge; residential proxy is not required. ## Actor input object example ```json { "mode": "search", "searchQuery": "iphone", "category": "smartfony", "productIds": [], "maxReviewsPerProduct": 20, "sortBy": "relevance", "inStockOnly": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `products` (type: `string`): Dataset containing all scraped Citilink products. # 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 = { "mode": "search", "searchQuery": "iphone", "category": "smartfony", "productIds": [], "maxReviewsPerProduct": 20, "sortBy": "relevance", "inStockOnly": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/citilink-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 = { "mode": "search", "searchQuery": "iphone", "category": "smartfony", "productIds": [], "maxReviewsPerProduct": 20, "sortBy": "relevance", "inStockOnly": False, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/citilink-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 '{ "mode": "search", "searchQuery": "iphone", "category": "smartfony", "productIds": [], "maxReviewsPerProduct": 20, "sortBy": "relevance", "inStockOnly": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/citilink-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/citilink-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/acts/lfCXOnpuZ8OZvUtDg/builds/uduBNUHbFExEYMvWj/openapi.json