IKEA Product Search Actor

Search and filter IKEA's product catalog with pagination and structured output.

Overview

This actor performs searches on IKEA's website. It returns detailed product data and supports advanced filtering, sorting, and pagination across multiple locales.

Key Features

• Keyword Search: Find products using terms like 'sofa' or 'lamp'.
• Advanced Filtering: Narrow results by color, price range, material, size, category, and more using filter IDs.
• Pagination & Sorting: Control result pages and sort by relevance, price, name, or rating.
• Multi-locale: Supports different country/language codes (e.g., en_US, de_DE).
• Structured Output: Returns consistent JSON with product details, variants, images, URLs, and available filter metadata.

How to Use

Configure the actor using input parameters. The only required field is the query. All filters use ID values, not names.

Finding Filter IDs

Filter IDs are not hardcoded. To get them:
1. Run an initial search without any filters.
2. In the output, examine the availableFilters array.
3. Use the id values from the specific filter options you want to apply.

Example availableFilters snippet:

{
  "title": "Colour",
  "values": [
    {"id": "10156", "title": "white", "count": 297},
    {"id": "10019", "title": "brown", "count": 219}
  ]
}

Input

Configure the actor run with a JSON object.

Required Parameter

• query (string): Your search term (e.g., "office desk").

Optional Parameters

• page (integer): Starting page number. Default: 1.
• perPage (integer): Number of results per page (max 100). Default: 24.
• sortBy (string): Sort method. Options: RELEVANCE, PRICE_LOW_TO_HIGH, PRICE_HIGH_TO_LOW, NAME_ASCENDING, NAME_DESCENDING, CUSTOMER_RATING. Default: RELEVANCE.
• localeCode (string): Country/language code. Default: en_US.

Optional Filters

All filter fields accept comma-separated IDs.
* colors (e.g., "10156,10019")
* price (e.g., "PRICE_0_2000,PRICE_2000_4000")
* size
* materials
* type
* brand
* category
* availability
* room
* features

Example Input

{
  "query": "office desk",
  "page": 1,
  "perPage": 48,
  "sortBy": "PRICE_LOW_TO_HIGH",
  "localeCode": "en_US",
  "filters": {
    "colors": "10156,10139",
    "materials": "47349,47350",
    "price": "PRICE_4000_6000"
  }
}

Output

The actor outputs a JSON object containing:
* results: The main container.
* pagination: Info on current page, items per page, and total available results.
* items: Contains the products array with details for each item:
* id, name, typeName
* price and currency
* pipUrl (product page link) and mainImageUrl
* colors, materials, itemMeasureReferenceText (measurements)
* onlineSellable (availability)
* Product variants data.
* availableFilters: A list of all filters applicable to the search, with their IDs, titles, and result counts. Use this to construct subsequent filtered searches.