# IKEA Scraper (`crawlerbros/ikea-scraper`) Actor Scrape IKEA products worldwide with prices, stock status, measurements, ratings, images, variants. Search by keyword, lookup by product ID, fetch from URL, or browse a category. Multi-country, multi-language. - **URL**: https://apify.com/crawlerbros/ikea-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 8 bookmarks - **User rating**: 5.00 out of 5 stars ## 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 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 ## IKEA Scraper Extract product data from **IKEA** storefronts across 50+ countries — prices, stock status, customer ratings, measurements, variants, images, and category paths. No login, cookies, or paid proxy required. ### What you get For every product: - `productId`, `name`, `typeName` (e.g. "Bookcase"), `description`, `brand` - `price` (amount + currency) - `rating`, `ratingCount` - `mainImageUrl`, `imageUrls[]` - `color`, `material`, `measurements` (height, width, depth, weight) - `categoryPath[]` — full breadcrumb (with `enrichFromPDP`) - `variants[]` — other colours / sizes of the same product, each with price + image - `badges[]`, `isBestseller`, `isNewArrival` - `stockStatus` — `in_stock`, `low_stock`, `out_of_stock`, etc. (PDP mode) - `productUrl`, `country`, `language`, `scrapedAt` Every field is omit-empty: a record never contains `null`, `""`, `[]`, or `{}`. ### How to use #### Search ```json { "mode": "search", "searchQuery": "BILLY bookcase", "country": "us", "language": "en", "sortBy": "PRICE_LOW_TO_HIGH", "maxItems": 25 } ```` #### Lookup by product ID ```json { "mode": "byProductIds", "productIds": ["20522046", "10522037", "00263850"], "country": "us", "language": "en" } ``` Article numbers print on IKEA labels as `205.220.46` — dots and spaces are accepted and normalized automatically. #### Fetch from product URLs ```json { "mode": "byUrls", "productUrls": [ "https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/", "https://www.ikea.com/de/de/p/billy-buecherregal-weiss-20522046/" ] } ``` Country and language are inferred from each URL. #### Browse a category ```json { "mode": "byCategory", "category": "bookcases-shelving-units-st002", "country": "us", "language": "en", "sortBy": "MOST_POPULAR", "maxItems": 100 } ``` ### Filters | Filter | Effect | |---|---| | `minPrice` / `maxPrice` | Price range in storefront currency | | `inStockOnly` | Exclude `out_of_stock` / not-online-sellable | | `containsKeyword` | Post-filter on name, type, description, color, category | | `minRating` | Exclude products rated below this value (0–5) | | `enrichFromPDP` | Fetch each PDP for richer fields (descriptions, measurements, breadcrumbs). Slower. | ### Supported markets 50 countries covering all major IKEA storefronts: United States, United Kingdom, Germany, France, Italy, Spain, Netherlands, Belgium, Austria, Switzerland, Sweden, Norway, Denmark, Finland, Poland, Czech Republic, Canada, Australia, Japan, South Korea, China, UAE, Saudi Arabia, India, Singapore, and more. Each country's language list is validated. Picking an invalid language for a country falls back automatically to that country's primary language. ### Sort orders Best match • Price: low → high • Price: high → low • Newest • Customer rating • Most popular • Name (A → Z) • Width / Height / Depth ### FAQ **Do I need cookies or a paid proxy?** No. The actor scrapes IKEA's public storefront via the official search-results API plus the public product pages. No authentication. The free Apify datacenter proxy is sufficient (optional). **Can I scrape every product on IKEA's site?** Yes — combine `mode=byCategory` with `category=products-products`. IKEA's search API caps category browses at a few thousand products per call; for larger sweeps, iterate sub-categories. **Does it work for any country?** Yes. The 50 supported storefronts cover every active IKEA online market. Each has the same field shape — only the currency, language and product mix change. **Will `productUrl` work?** Yes — every `productUrl` is the canonical PDP that 200s in a clean browser. **Are variants real?** Yes — `variants[]` lists every colour/configuration of the same SKU family, each with its own `productId`, `price`, and image. These are real product IDs you can re-query via `byProductIds`. **What does `enrichFromPDP` add?** Description, measurements (height/width/depth/weight), the full category breadcrumb, and rich `stockStatus` from schema.org Offers. Cost: one extra HTTP request per product (~0.3 s). **What is the recordType?** Every record carries `recordType: "product"` for easy filtering downstream. ### Limitations - **Inventory at store-level** (which IKEA store has the item) requires the IKEA app's geo-gated API and isn't exposed here. - **Customer reviews** are returned only via `enrichFromPDP` and capped to the 5 most-recent reviews JSON-LD exposes. - **Assembly / shipping cost** isn't on the public product schema. ### Data source The actor calls IKEA's official public search-result-page API (`sik.search.blue.cdtapps.com/{cc}/{lang}/search-result-page`) for listings, and the public product detail pages (`www.ikea.com/{cc}/{lang}/p/...`) for enrichment. Both are openly readable from any IP and serve schema.org-formatted data designed for indexing. # Actor input Schema ## `mode` (type: `string`): How to find products. ## `searchQuery` (type: `string`): Free-text search query, e.g. `bookcase`, `BILLY`, `sofa`. Searches the IKEA storefront for the selected country/language. ## `productIds` (type: `array`): IKEA 8-digit article numbers (e.g. `20522046`, `00263850`). Dots/spaces allowed; we normalize. One ID per line. ## `productUrls` (type: `array`): Full IKEA product page URLs, e.g. `https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/`. One URL per line. ## `category` (type: `string`): Top-level IKEA category slug. Required for mode=byCategory; optional filter for mode=search. ## `country` (type: `string`): IKEA market storefront (ISO 3166-1 alpha-2 code). ## `language` (type: `string`): Language code for the storefront. Must be valid for the selected country (auto-falls-back to the country's primary language if invalid). ## `sortBy` (type: `string`): Sort order applied at the IKEA API level. ## `minPrice` (type: `integer`): Exclude products with price below this value (storefront currency). ## `maxPrice` (type: `integer`): Exclude products with price above this value (storefront currency). ## `minRating` (type: `integer`): Exclude products rated below this value (0–5). Products with no rating are kept. ## `inStockOnly` (type: `boolean`): If true, exclude products that are out of stock or unavailable online. ## `containsKeyword` (type: `string`): Post-filter: only emit products whose name, description, color, or category contains this substring (case-insensitive). ## `enrichFromPDP` (type: `boolean`): When true, fetches each product's PDP for richer fields (description, measurements, breadcrumb categories). Slower but more complete. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "search", "searchQuery": "bookcase", "productIds": [], "productUrls": [], "category": "", "country": "us", "language": "en", "sortBy": "RELEVANCE", "inStockOnly": false, "enrichFromPDP": false, "maxItems": 15 } ``` # Actor output Schema ## `products` (type: `string`): Dataset containing all scraped IKEA 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": "bookcase", "productIds": [], "productUrls": [], "country": "us", "language": "en", "sortBy": "RELEVANCE", "inStockOnly": false, "enrichFromPDP": false, "maxItems": 15 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/ikea-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": "bookcase", "productIds": [], "productUrls": [], "country": "us", "language": "en", "sortBy": "RELEVANCE", "inStockOnly": False, "enrichFromPDP": False, "maxItems": 15, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/ikea-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": "bookcase", "productIds": [], "productUrls": [], "country": "us", "language": "en", "sortBy": "RELEVANCE", "inStockOnly": false, "enrichFromPDP": false, "maxItems": 15 }' | apify call crawlerbros/ikea-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/ikea-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "IKEA Scraper", "description": "Scrape IKEA products worldwide with prices, stock status, measurements, ratings, images, variants. Search by keyword, lookup by product ID, fetch from URL, or browse a category. Multi-country, multi-language.", "version": "1.1", "x-build-id": "PpTeVpLkCtz4HgMvj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~ikea-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-ikea-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/crawlerbros~ikea-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-ikea-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/crawlerbros~ikea-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-ikea-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byProductIds", "byUrls", "byCategory" ], "type": "string", "description": "How to find products.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text search query, e.g. `bookcase`, `BILLY`, `sofa`. Searches the IKEA storefront for the selected country/language.", "default": "bookcase" }, "productIds": { "title": "Product IDs (mode=byProductIds)", "type": "array", "description": "IKEA 8-digit article numbers (e.g. `20522046`, `00263850`). Dots/spaces allowed; we normalize. One ID per line.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs (mode=byUrls)", "type": "array", "description": "Full IKEA product page URLs, e.g. `https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/`. One URL per line.", "default": [], "items": { "type": "string" } }, "category": { "title": "Category (mode=byCategory or as filter)", "enum": [ "", "products-products", "storage-organization-st001", "bookcases-shelving-units-st002", "dressers-storage-drawers-st004", "beds-mattresses-bm001", "sofas-armchairs-fu002", "tables-desks-de001", "chairs-fu004", "bedroom-bm002", "bathroom-ba001", "kitchen-ki001", "living-room-lr001", "outdoor-od001", "home-textiles-tl001", "lighting-li001", "rugs-mats-flooring-rm001", "decoration-de001", "appliances-ka002", "baby-kids-bc001", "office-of001" ], "type": "string", "description": "Top-level IKEA category slug. Required for mode=byCategory; optional filter for mode=search.", "default": "" }, "country": { "title": "Country / Storefront", "enum": [ "us", "gb", "ie", "ca", "au", "nz", "in", "sg", "my", "ph", "th", "hk", "tw", "jp", "kr", "cn", "ae", "sa", "qa", "kw", "bh", "jo", "eg", "ma", "de", "fr", "it", "es", "pt", "nl", "be", "at", "ch", "se", "no", "dk", "fi", "is", "pl", "cz", "sk", "hu", "ro", "hr", "rs", "bg", "gr", "ru", "ua", "tr" ], "type": "string", "description": "IKEA market storefront (ISO 3166-1 alpha-2 code).", "default": "us" }, "language": { "title": "Language", "enum": [ "en", "de", "fr", "it", "es", "pt", "nl", "sv", "no", "da", "fi", "is", "pl", "cs", "sk", "hu", "ro", "hr", "sr", "bg", "el", "ru", "uk", "tr", "ja", "ko", "zh", "th", "ms", "ar" ], "type": "string", "description": "Language code for the storefront. Must be valid for the selected country (auto-falls-back to the country's primary language if invalid).", "default": "en" }, "sortBy": { "title": "Sort by", "enum": [ "RELEVANCE", "PRICE_LOW_TO_HIGH", "PRICE_HIGH_TO_LOW", "NEWEST", "RATING", "MOST_POPULAR", "NAME_ASCENDING", "WIDTH", "HEIGHT", "DEPTH" ], "type": "string", "description": "Sort order applied at the IKEA API level.", "default": "RELEVANCE" }, "minPrice": { "title": "Minimum price", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Exclude products with price below this value (storefront currency)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Exclude products with price above this value (storefront currency)." }, "minRating": { "title": "Minimum customer rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Exclude products rated below this value (0–5). Products with no rating are kept." }, "inStockOnly": { "title": "In-stock only", "type": "boolean", "description": "If true, exclude products that are out of stock or unavailable online.", "default": false }, "containsKeyword": { "title": "Contains keyword", "type": "string", "description": "Post-filter: only emit products whose name, description, color, or category contains this substring (case-insensitive)." }, "enrichFromPDP": { "title": "Enrich from product page", "type": "boolean", "description": "When true, fetches each product's PDP for richer fields (description, measurements, breadcrumb categories). Slower but more complete.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 } } }, "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 } } } } } } } } } } ```