# RS Online Listings Scraper (`piotrv1001/rs-online-listings-scraper`) Actor The RS Online Listings Scraper extracts product listings and full records from RS Online across 29 country stores, capturing stock numbers, brands, MPNs, localised prices with quantity breaks, stock, specifications and datasheets — ideal for price monitoring and BOM costing. - **URL**: https://apify.com/piotrv1001/rs-online-listings-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 product listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ### 🚀 RS Online Listings Scraper Extract **product data from [RS Online](https://uk.rs-online.com/) (RS Group) at scale**. The **RS Online Listings Scraper** pulls stock numbers, brands, manufacturer part numbers, **local prices with quantity breaks**, live availability, **full parametric specifications** and **datasheet PDFs** into clean, structured JSON — ready for price monitoring, BOM costing, competitor analysis and catalogue enrichment. RS is one of the largest industrial and electronics distributors in the world, with over **1.2 million products** and **29 country stores**. This Actor makes that catalogue queryable, exportable and schedulable, with API access, scheduling, integrations and monitoring on the [Apify platform](https://apify.com). ### ✨ Features - 🏷️ **Complete product records** – title, RS stock number, brand, manufacturer part number, price, availability, image, category and specifications. - 🌍 **29 country stores** – UK, Ireland, Germany, France, Italy, Spain, Netherlands, Belgium, Austria, Switzerland, the Nordics, Poland, Portugal, Czechia, Hungary, Australia, New Zealand, Singapore, Malaysia, the Philippines, Hong Kong, Thailand, Taiwan, China, Japan, South Korea and South Africa — each with **local language, currency and pricing**. - 💰 **Quantity price breaks** – the whole price ladder (1 / 5 / 10 / 30 / 100+), unit price and pack price, plus MOQ, order multiples and the local tax rate. - 🔬 **Full specification tables** – every parametric attribute RS publishes for a part, from voltage and tolerance to thread size and IP rating. - 📄 **Datasheets and documents** – direct PDF links to datasheets, selection guides and manufacturer information. - 📂 **Whole-category exports** – point it at any category URL and export it in full, with automatic pagination all the way down. - 🔍 **Keyword search** – look products up by search term instead of browsing categories. - ⚡ **Fast and cheap** – thousands of products per minute, no proxies required. ### 💡 Why use the RS Online Listings Scraper? - **Price monitoring** – track RS pricing across markets and spot changes on a daily schedule. - **Cross-market arbitrage** – the same stock number in 29 currencies, side by side. - **BOM costing** – price a bill of materials with real quantity breaks instead of single-unit prices. - **Competitor benchmarking** – compare RS against Farnell, Mouser, Digi-Key or RS PRO's own-brand range. - **Catalogue enrichment** – fill your PIM with clean specification tables, images and datasheet links. - **Stock and availability tracking** – know what is actually buyable today, market by market. ### 🛠️ How to use the RS Online Listings Scraper 1. **Choose what to scrape** – paste RS category URLs, individual product URLs, or type search terms. Any combination works. 2. **Pick your market** – choose the country store that search terms should use. Category and product URLs use their own domain automatically. 3. **Set your limit** – pick how many products to save with **Maximum items**. Start small to preview the data. 4. **Optionally go deeper** – tick **Scrape full product details** for specification tables, datasheets and price breaks. 5. **Run it** – click **Start**. Results appear in the **Output** tab within seconds. 6. **Export or integrate** – download as JSON, CSV, Excel or HTML, or pull it via the [Apify API](https://docs.apify.com/api/v2). ### 📥 Input | Field | Type | Description | | -------------------- | ------- | --------------------------------------------------------------------------------------------------------------------- | | `startUrls` | array | RS category URLs (e.g. `https://uk.rs-online.com/web/c/cables-wires/`) or product URLs. Market taken from the domain. | | `searchTerms` | array | Keywords to look up, e.g. `digital multimeter`, `M4 socket screw`. | | `country` | string | Country store used for search terms, e.g. `GB`, `DE`, `AU`. Controls language, currency and local pricing. | | `maxItems` | integer | Maximum number of products to save. Default `50`. | | `scrapeDetails` | boolean | Open every product for the full record. Default `false`. | | `proxyConfiguration` | object | Optional. Proxies are not required for this Actor. | Example input: ```json { "startUrls": [{ "url": "https://uk.rs-online.com/web/c/test-measurement/" }], "searchTerms": ["digital multimeter"], "country": "GB", "maxItems": 100, "scrapeDetails": false } ```` ### 📊 Output You can download the dataset in various formats such as JSON, HTML, CSV or Excel. Listing record: ```json { "stockNumber": "123-2229", "articleId": "1232229", "title": "RS PRO Sound Level Calibrator, ±0.5 dB Accuracy, 114 dB Output, 25.4 mm Microphone", "url": "https://uk.rs-online.com/web/p/sound-level-calibrators/1232229", "brand": "RS PRO", "manufacturerPartNumber": null, "price": 241.76, "displayPrice": "£241.76", "currency": "GBP", "availability": "IN_STOCK", "image": "https://media.rs-online.com/t_large/F1232229-01.jpg", "category": "Sound Level Calibrators", "categoryUrl": "https://uk.rs-online.com/web/c/test-measurement/environmental-test-measurement/sound-level-calibrators/", "packSize": "1", "salesUnitOfMeasure": "EA", "baseUnitOfMeasure": "EA", "flags": ["RSPRO"], "specifications": { "Brand": "RS PRO", "Product Type": "Sound Level Calibrator", "Sound Output": "114dB", "Frequency": "1000Hz", "Accuracy": "±0.5 dB", "Battery Life": "20h" }, "country": "GB" } ``` With **Scrape full product details** enabled, each record additionally carries: ```json { "priceBreaks": [ { "fromQuantity": 1, "unitPrice": 0.379, "packPrice": 18.93, "displayPrice": "18,93 €" }, { "fromQuantity": 10, "unitPrice": 0.34, "packPrice": 17.02, "displayPrice": "17,02 €" } ], "minimumOrderQuantity": 1, "orderMultiples": 1, "taxRatePercentage": 19, "categoryPath": ["Electrical, Automation & Cables", "Cables & Wires", "AV Cables", "Audio Cable"], "countryOfOrigin": "CN", "datasheetUrl": "https://docs.rs-online.com/6f81/0900766b8157f120.pdf", "documents": [ { "title": "Datasheet", "type": "data_sheet", "url": "https://docs.rs-online.com/6f81/0900766b8157f120.pdf" } ], "isRestricted": false, "isCalibrated": false, "inStock": true } ``` #### Data fields | Field | Description | | ----------------------------------------------------------------- | ---------------------------------------------------------------- | | `stockNumber` | RS stock number in its familiar `123-2229` form | | `articleId` | The same number as used in product URLs | | `title` | Full product title, in the language of the market | | `url` | Product page URL | | `brand`, `brandUrl` | Manufacturer or own-brand name and brand page | | `manufacturerPartNumber`, `sku` | MPN and RS SKU | | `price`, `displayPrice`, `currency` | Price excluding tax, formatted price and currency code | | `priceBreaks` | Quantity price ladder with unit and pack prices *(details mode)* | | `minimumOrderQuantity`, `orderMultiples` | Ordering constraints *(details mode)* | | `taxRatePercentage` | Local VAT/GST rate *(details mode)* | | `availability`, `inStock` | Stock status | | `image` | Primary product image | | `category`, `categoryUrl`, `categoryPath` | Leaf category, its URL, and the full category hierarchy | | `specifications` | Parametric attribute table as a key/value object | | `documents`, `datasheetUrl` | Datasheet and document PDFs *(details mode)* | | `packSize`, `salesUnitOfMeasure`, `baseUnitOfMeasure` | Packaging and units of measure | | `countryOfOrigin`, `energyRating`, `isRestricted`, `isCalibrated` | Compliance and handling flags | | `country` | The market the record was scraped from | ### 💵 How much does it cost to scrape RS Online? This Actor uses **pay per event** pricing — you pay for the data you get, not for compute time. | Event | Price | When it's charged | | ------------------- | ---------- | ----------------------------------------------------------- | | Product listing | **$0.003** | Per product from a category URL or search term | | Full product record | **$0.008** | Per product scraped with **Scrape full product details** on | Examples: - Exporting **1,000 products** from a category costs **$3.00**. - Exporting **1,000 products with full details** costs **$8.00**. - A **50-product preview run** costs **$0.15**. With the Apify Free plan's **$5 of monthly credit** you can scrape roughly **1,600 products per month at no cost**. ### 💡 Tips - **Start with a low `maxItems`** to preview the output shape before committing to a large export. - **Leave `scrapeDetails` off** unless you need specification tables, datasheets or price breaks — listing records already carry price, stock, brand, MPN, image, category and a summary spec table at less than half the cost. - **Scrape a subcategory, not the root.** `cables-wires/av-cables` returns a focused set; `cables-wires` returns nearly 80,000 products. - **Compare markets** by running the same category with different country domains, then joining on `stockNumber`. - **Schedule a daily run** and connect it to Google Sheets, Slack or your warehouse via [Apify integrations](https://apify.com/integrations). ### ❓ FAQ **Which markets are supported?** GB, IE, DE, FR, IT, ES, NL, BE, AT, CH, DK, SE, NO, PL, PT, CZ, HU, AU, NZ, SG, MY, PH, HK, TH, TW, CN, JP, KR and ZA. Titles, specifications, categories and prices all come back localised. **Are prices with or without tax?** Prices are list prices **excluding tax**, as shown to a logged-out visitor. The local tax rate is included in details mode so you can gross them up. Account-specific contract pricing is not available. **Some of my search terms return nothing.** Very broad head terms (for example `cable` on its own) are handled by the site as category navigation rather than a search and return no results. Use a more specific term, or point the Actor at the category URL instead. **Can I get the whole 1.2 million product catalogue?** Yes — set a high `maxItems` and give it category URLs. Note that products appear in several categories; records are deduplicated by stock number within a run. **Is scraping RS Online legal?** This Actor collects only publicly available product information — no personal data and nothing behind a login. As with any scraping project, you are responsible for how you use the data, and you should review RS's terms and consult a lawyer if you are unsure. **Something is missing or broken.** Open an issue on the **Issues** tab and it will be looked at. Custom versions and adjacent distributor scrapers can be built on request. # Actor input Schema ## `startUrls` (type: `array`): RS Online category URLs (e.g. https://uk.rs-online.com/web/c/cables-wires/) or individual product URLs. The market is taken from the domain of each URL. ## `searchTerms` (type: `array`): Keywords to look up in the RS catalogue, e.g. "digital multimeter". Searched in the market selected below. ## `country` (type: `string`): Country store used for search terms, and for URLs whose domain is not recognised. Controls language, currency and local pricing. ## `maxItems` (type: `integer`): Maximum number of products to save. Keep it low for a quick test run. ## `scrapeDetails` (type: `boolean`): Open every product for the complete record: full specification table, datasheet PDFs, quantity price breaks, category hierarchy and packaging data. Slower and more expensive than listing data alone. ## `proxyConfiguration` (type: `object`): Optional. Proxies are not required for this Actor, but you can route traffic through Apify Proxy if you want to. ## Actor input object example ```json { "startUrls": [ { "url": "https://uk.rs-online.com/web/c/test-measurement/" } ], "searchTerms": [ "digital multimeter" ], "country": "GB", "maxItems": 50, "scrapeDetails": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (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 = { "startUrls": [ { "url": "https://uk.rs-online.com/web/c/test-measurement/" } ], "searchTerms": [ "digital multimeter" ] }; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/rs-online-listings-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 = { "startUrls": [{ "url": "https://uk.rs-online.com/web/c/test-measurement/" }], "searchTerms": ["digital multimeter"], } # Run the Actor and wait for it to finish run = client.actor("piotrv1001/rs-online-listings-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 '{ "startUrls": [ { "url": "https://uk.rs-online.com/web/c/test-measurement/" } ], "searchTerms": [ "digital multimeter" ] }' | apify call piotrv1001/rs-online-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=piotrv1001/rs-online-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "RS Online Listings Scraper", "description": "The RS Online Listings Scraper extracts product listings and full records from RS Online across 29 country stores, capturing stock numbers, brands, MPNs, localised prices with quantity breaks, stock, specifications and datasheets — ideal for price monitoring and BOM costing.", "version": "0.0", "x-build-id": "k3hvgqrqCm3yEnQwh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~rs-online-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-rs-online-listings-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/piotrv1001~rs-online-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-rs-online-listings-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/piotrv1001~rs-online-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-rs-online-listings-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": { "startUrls": { "title": "Category or product URLs", "type": "array", "description": "RS Online category URLs (e.g. https://uk.rs-online.com/web/c/cables-wires/) or individual product URLs. The market is taken from the domain of each URL.", "default": [ { "url": "https://uk.rs-online.com/web/c/test-measurement/" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to look up in the RS catalogue, e.g. \"digital multimeter\". Searched in the market selected below.", "default": [], "items": { "type": "string" } }, "country": { "title": "Market", "enum": [ "GB", "IE", "DE", "FR", "IT", "ES", "NL", "BE", "AT", "CH", "DK", "SE", "NO", "PL", "PT", "CZ", "HU", "AU", "NZ", "SG", "MY", "PH", "HK", "TH", "TW", "CN", "JP", "KR", "ZA" ], "type": "string", "description": "Country store used for search terms, and for URLs whose domain is not recognised. Controls language, currency and local pricing.", "default": "GB" }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Maximum number of products to save. Keep it low for a quick test run.", "default": 50 }, "scrapeDetails": { "title": "Scrape full product details", "type": "boolean", "description": "Open every product for the complete record: full specification table, datasheet PDFs, quantity price breaks, category hierarchy and packaging data. Slower and more expensive than listing data alone.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Proxies are not required for this Actor, but you can route traffic through Apify Proxy if you want to.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```