IKEA Products By Category Scraper - Apify Actor Documentation

Overview

The IKEA Products By Category Scraper is an Apify Actor that extracts product information from IKEA's online catalog by category. It retrieves products, filters, sorting options, and pagination data from any IKEA category page across different countries and languages.

Features

• 🛋️ Product Extraction: Get detailed product information from IKEA categories
• 🌍 Multi-Country Support: Works with 70+ IKEA markets worldwide
• 🔍 Advanced Filtering: Extract available filters (color, size, price, etc.)
• 📄 Pagination Control: Customize page size and navigate through results
• 🔤 Multi-Language: Support for local languages in different markets
• ⚡ Fast & Reliable: Built on Apify's robust infrastructure

Input Parameters

Required Parameters

Parameter	Type	Description
categoryUrl	String	The IKEA category URL you want to scrape

Optional Parameters

Parameter	Type	Default	Description
page	String	"1"	Page number to retrieve (starts from 1)
perPage	String	"24"	Number of products per page (max recommended: 100)
sortBy	String	"RELEVANCE"	Sort order for products
localeCode	String	"en_US"	Language and country code

Sort Options

Available sorting options for sortBy parameter:

• "RELEVANCE" - Most relevant results (default)
• "PRICE_LOW_TO_HIGH" - Price: Low to High
• "PRICE_HIGH_TO_LOW" - Price: High to Low
• "CUSTOMER_RATE" - Customer Rating
• "NEW" - Newest Products
• "NAME" - Alphabetical Order

Supported Locale Codes

The actor supports 70+ markets. Here are some popular ones:

Locale Code	Country & Language
en_US	English (United States)
en_GB	English (United Kingdom)
de_DE	German (Germany)
fr_FR	French (France)
es_ES	Spanish (Spain)
it_IT	Italian (Italy)
ja_JP	Japanese (Japan)
en_AU	English (Australia)
en_CA	English (Canada)
fr_CA	French (Canada)

View complete list of supported locales

Input Example

{
  "categoryUrl": "https://www.ikea.com/us/en/cat/sofas-fu003/",
  "page": "1",
  "perPage": "48",
  "sortBy": "PRICE_LOW_TO_HIGH",
  "localeCode": "en_US"
}

Output Structure

The actor returns a JSON object with the following structure:

{
  "results": {
    "pagination": {
      "page": 1,
      "perPage": 24,
      "totalAvailable": 150,
      "itemsPerType": {
        "PRODUCT": 145,
        "CONTENT": 3,
        "PLANNER": 2
      }
    },
    "items": {
      "products": [...],
      "content": [...],
      "planner": [...],
      "categories": [...],
      "mattress_warranty": [...]
    }
  },
  "filters": {
    "filters": [...],
    "sortBy": [...]
  }
}

Product Object Structure

Each product in the products array contains:

{
  "id": "40299687",
  "name": "EKTORP",
  "typeName": "3-seat sofa",
  "price": {
    "current": 399,
    "currency": "USD",
    "prefix": "$"
  },
  "images": [...],
  "url": "/us/en/p/ektorp-3-seat-sofa-40299687/",
  "colors": [...],
  "sizes": [...],
  "availability": {...}
}

Filter Object Structure

Filters help you understand available filtering options:

{
  "titleInEnglish": "Colour",
  "title": "Color",
  "values": [
    {
      "id": "10156",
      "title": "Beige",
      "count": 25,
      "selected": false,
      "enabled": true,
      "hex": "#F5F5DC"
    }
  ]
}

Getting Started

Step 1: Find Your Category URL

1. Go to IKEA website
2. Navigate to any product category (e.g., Sofas, Tables, Beds)
3. Copy the full URL from your browser

Example URLs:

• https://www.ikea.com/us/en/cat/sofas-fu003/
• https://www.ikea.com/gb/en/cat/dining-tables-21825/
• https://www.ikea.com/de/de/cat/betten-bm003/

Step 2: Configure Your Input

Create an input JSON with your parameters:

{
  "categoryUrl": "YOUR_CATEGORY_URL_HERE",
  "page": "1",
  "perPage": "24",
  "localeCode": "en_US"
}

Step 3: Run the Actor

The actor will automatically:

1. Extract the category ID from your URL
2. Fetch products from IKEA's API
3. Format and return the data

Use Cases

E-commerce Price Monitoring

{
  "categoryUrl": "https://www.ikea.com/us/en/cat/sofas-fu003/",
  "sortBy": "PRICE_LOW_TO_HIGH",
  "perPage": "100"
}

Market Research Across Countries

{
  "categoryUrl": "https://www.ikea.com/de/de/cat/sofas-fu003/",
  "localeCode": "de_DE",
  "perPage": "50"
}

Product Catalog Analysis

{
  "categoryUrl": "https://www.ikea.com/us/en/cat/beds-bm003/",
  "sortBy": "NEW",
  "page": "1"
}

Error Handling

The actor handles various error scenarios:

• Invalid Category URL: Returns error if category ID cannot be extracted
• Unsupported Locale: Falls back to default if locale code is invalid
• Network Issues: Retries failed requests automatically
• Empty Results: Returns empty arrays if no products found

Tips for Best Results

1. URL Formats

✅ Correct: https://www.ikea.com/us/en/cat/sofas-fu003/ ❌ Incorrect: https://www.ikea.com/us/en/products/

2. Pagination

• Start with perPage: "24" for testing
• Increase to perPage: "100" for bulk extraction
• Use page parameter to get all results

3. Locale Selection

• Match the locale with your category URL country
• Use en_US for US URLs, de_DE for German URLs, etc.

4. Rate Limiting

• The actor respects IKEA's rate limits
• For large-scale scraping, consider adding delays between runs

Complete Locale List

Support & Troubleshooting

Common Issues

Issue: "Category ID not found"

• Solution: Check if your URL is a valid IKEA category page
• Example: Use /cat/sofas-fu003/ instead of /products/sofa/

Issue: No products returned

• Solution: Try different localeCode or check if category exists in that market

Issue: Rate limiting errors

• Solution: Reduce request frequency or use Apify's built-in proxy rotation

Need Help?

• Check the actor's run logs for detailed error messages
• Verify your input parameters match the expected format
• Test with a simple category URL first

Related Actor

• Ikea Product Search

---

Support

If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels:

• Telegram: @pintoflow
• Email: pintoflowpt@gmail.com
• Apify Platform: You can also contact us directly through this platform.

---