# Ulybka Radugi Scraper (`sashaebashu/r-ulybka-scraper`) Actor Scrape the Ulybka Radugi (r-ulybka.ru) beauty & drugstore catalog by category — name, price, discount, stock and brand. Fast, cheap datacenter proxy. - **URL**: https://apify.com/sashaebashu/r-ulybka-scraper.md - **Developed by:** [Sasha Ebashu](https://apify.com/sashaebashu) (community) - **Categories:** E-commerce, Other, Automation - **Stats:** 2 total users, 1 monthly users, 100.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 ## Ulybka Radugi Scraper Scrape the **Ulybka Radugi / Улыбка радуги** (`r-ulybka.ru`) beauty & drugstore catalog by category and get clean, structured data for every product — **name, price, old price, discount, stock quantity, bonus points and brand**. No login, no API key. Fast, cheap (runs on **datacenter** proxy), stable. Export to **JSON, CSV, Excel or Google Sheets**. --- ### What it extracts For every product in a category: - 🏷️ **Name** and **brand** - 💰 **Price** (₽), **old price** and **discount %** when on sale - 📦 **Stock quantity** — the real available count (`stock`), plus SPb-warehouse stock — most beauty scrapers can't get this - 🎁 **Bonus** points, **article** number, **product ID**, **slug** and **image** - 🗂️ The **category** it came from and a **scrapedAt** timestamp Run it on a schedule and diff the results to watch competitor prices **and stock** move. --- ### How to use it 1. Add one or more **category URLs** (or just their slugs): - Full URL: `https://www.r-ulybka.ru/catalog/skidki/` - Slug only: `skidki` - Examples: `skidki` (discounts), `novinki` (new), `korieiskaia-kosmietika` (Korean cosmetics), `produkty`. Nested category URLs work too. 2. Set **max pages per category** (36 products per page) and an optional total **max items** cap. 3. Run it, then download or pull the results via API. --- ### Cost & proxy The catalog is served over Apify's **datacenter proxy** (the default) — so this scraper is **cheap and fast**, no residential proxy required. Apify's **$5/month free credits** go a long way here. --- ### Input parameters | Parameter | Type | Description | Default | | --- | --- | --- | --- | | `categoryUrls` | array | Category page URLs or slugs to scrape | one example category | | `maxPagesPerCategory` | integer | Result pages per category (36 items each); 0 = until the category ends | 10 | | `maxItems` | integer | Stop after this many products in total (0 = unlimited) | 0 | | `monitorMode` | boolean | Compare this run to the previous one (same categories) and tag price/stock changes — see below | false | | `onlyChanges` | boolean | With monitor mode on, return only the products that changed | false | | `proxyConfiguration` | object | Proxy — Apify datacenter is enough | datacenter | --- ### Output fields | Field | Description | |---|---| | `store` | Always `"r-ulybka"`. | | `id` | Product ID. | | `name` | Product name. | | `brand` | Brand name. | | `article` | Vendor article number. | | `slug` | Product slug. | | `price` | Current price, ₽. | | `oldPrice` | Regular price, ₽, when on sale (else `null`). | | `discountPct` | Discount percentage when on sale (else `null`). | | `bonus` | Loyalty bonus points on the product. | | `currency` | Always `"RUB"`. | | `stock` | Total available stock quantity. | | `stockSpb` | Stock at the St. Petersburg warehouse. | | `isNew` | Whether the product is flagged new. | | `image` | Product image URL. | | `categoryPath` | The category the product was scraped from. | | `scrapedAt` | Timestamp of the run. | --- ### Price & stock monitor (track changes over time) Turn on **`monitorMode`** and run it on a schedule: each run is compared to the previous one (same categories), so you see **what actually changed** instead of a fresh dump every time. Each row gains: - `changeType` — `new`, `price_up`, `price_down`, `stock_change` or `unchanged` - `previousPrice` — the price at the last run (`null` for new products) - `firstSeenAt` / `lastConfirmedAt` — data-freshness stamps (tell fresh data from stale) - `priceLow30` / `priceHigh30` — rolling 30-day low and high (spot fake discounts) Add **`onlyChanges`** to output just the products that moved — a clean delta for alerts or a dashboard. Off by default, so normal runs are unaffected. --- ### Notes - Only public catalog data is collected. Respect Ulybka Radugi's Terms of Service and your local regulations. # Actor input Schema ## `categoryUrls` (type: `array`): r-ulybka.ru category pages to scrape. Paste full URLs like https://www.r-ulybka.ru/catalog/skidki/ or just the slug (skidki). Examples: skidki (discounts), novinki (new), korieiskaia-kosmietika (Korean cosmetics), produkty. Nested category URLs work too. ## `maxPagesPerCategory` (type: `integer`): How many result pages (36 products each) to fetch per category. 0 = until the category ends. ## `maxItems` (type: `integer`): Stop after this many products in total (0 = unlimited). ## `monitorMode` (type: `boolean`): Compare this run to the previous one (same categories) and tag each product with what changed: changeType (new / price_up / price_down / stock_change / unchanged), previousPrice, firstSeenAt / lastConfirmedAt (data-freshness stamps), and priceLow30 / priceHigh30 (rolling 30-day low & high — spot fake discounts). Turns the scraper into a price monitor you run on a schedule. Off by default — normal runs are unaffected. ## `onlyChanges` (type: `boolean`): With monitor mode on, output only the products whose price or stock changed (or that are new) since the last run — a clean delta for alerts or a dashboard. ## `proxyConfiguration` (type: `object`): Apify datacenter proxy is enough (cheap) — residential is not required. ## Actor input object example ```json { "categoryUrls": [ "https://www.r-ulybka.ru/catalog/skidki/" ], "maxPagesPerCategory": 10, "maxItems": 0, "monitorMode": false, "onlyChanges": false, "proxyConfiguration": { "useApifyProxy": true } } ```` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "categoryUrls": [ "https://www.r-ulybka.ru/catalog/skidki/" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("sashaebashu/r-ulybka-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 = { "categoryUrls": ["https://www.r-ulybka.ru/catalog/skidki/"], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("sashaebashu/r-ulybka-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 '{ "categoryUrls": [ "https://www.r-ulybka.ru/catalog/skidki/" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call sashaebashu/r-ulybka-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sashaebashu/r-ulybka-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ulybka Radugi Scraper", "description": "Scrape the Ulybka Radugi (r-ulybka.ru) beauty & drugstore catalog by category — name, price, discount, stock and brand. Fast, cheap datacenter proxy.", "version": "0.1", "x-build-id": "aCPwDva9KJP3hSueK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sashaebashu~r-ulybka-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sashaebashu-r-ulybka-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/sashaebashu~r-ulybka-scraper/runs": { "post": { "operationId": "runs-sync-sashaebashu-r-ulybka-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/sashaebashu~r-ulybka-scraper/run-sync": { "post": { "operationId": "run-sync-sashaebashu-r-ulybka-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": { "categoryUrls": { "title": "Category URLs or slugs", "type": "array", "description": "r-ulybka.ru category pages to scrape. Paste full URLs like https://www.r-ulybka.ru/catalog/skidki/ or just the slug (skidki). Examples: skidki (discounts), novinki (new), korieiskaia-kosmietika (Korean cosmetics), produkty. Nested category URLs work too.", "items": { "type": "string" } }, "maxPagesPerCategory": { "title": "Max pages per category", "minimum": 0, "type": "integer", "description": "How many result pages (36 products each) to fetch per category. 0 = until the category ends.", "default": 10 }, "maxItems": { "title": "Max output rows", "minimum": 0, "type": "integer", "description": "Stop after this many products in total (0 = unlimited).", "default": 0 }, "monitorMode": { "title": "Monitor mode (price & stock change tracking)", "type": "boolean", "description": "Compare this run to the previous one (same categories) and tag each product with what changed: changeType (new / price_up / price_down / stock_change / unchanged), previousPrice, firstSeenAt / lastConfirmedAt (data-freshness stamps), and priceLow30 / priceHigh30 (rolling 30-day low & high — spot fake discounts). Turns the scraper into a price monitor you run on a schedule. Off by default — normal runs are unaffected.", "default": false }, "onlyChanges": { "title": "Return only changed products", "type": "boolean", "description": "With monitor mode on, output only the products whose price or stock changed (or that are new) since the last run — a clean delta for alerts or a dashboard.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is enough (cheap) — residential is not required." } } }, "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 } } } } } } } } } } ```