Product Add-ons service
Add-on products provide value for customers and increase commerciality.
Showing and recommending add-on products help customers improve a product or solution they are going to buy or already have at home. They can complete and/or complement a main product, and stimulate impulse purchases to create add-on sales.
Problem statement
Today, add-on products to a product is managed manually in PIA using the entity “complementary item”. This means that each product has to get their defined add-on products through a subject matter expert who adds items by hand and the amount of relations are limited both in the coverage of main products as well as the number of add-ons per main product.
The lack of add-on products per main product means that there is not enough recommendations to combine with the main product and other means are considered and wrong recommendations are shown on IKEA.com.
Service offer
Using our Add-on product service, you send an article number to the service and you will get a response back with add-on products that go well with the main product.
Product Add-ons changelog
2025-09-04
Removed:
Removed the planners endpoint /planners/products/add-ons.
Removed the planners endpoint /planners/products/add-ons.
2025-07-07
Changed
Market specific End Date Sales: Changed from +175 days to +360 days
All the API endpoints are updated to include products for the range of sale end date +360 days in the response when enableMarketSalesData is set to true in request query parameter. Please refer to the API specification for details
2025-06-18
Changed
Host Name: Changed from knowledge.api.inter.ikea.com to knowledge.api.inter.ikea.net
API Gateway migration: Moved from Akamai to Azure APIM
Base url is changed to https://knowledge.api.inter.ikea.net/cbr/rosd/ikg/api/product-add-ons/v1
Action Required: Update all API client configurations to point to the new base URL
Authentication Header Format: Minor update – use Subscription-Key instead of X-Client-Id header
Action Required: Modify all requests to use the new header key: Subscription-Key
2025-05-06
Changed
Improved product add-ons results.
The API now delivers even better and more relevant results.
More add-on connections have been created by the inclusion of items from more product areas, such as Integrated lighting and Cleaning & cleaning accessories. Add-on relevance scores have been improved by the inclusion and evaluation of more product family-to-product family connections.
2024-12-27
Removed
Removed indicators field from response schema of all endpoints.
Removed the indicators field from response schema of all endpoints.
2024-11-07
Updated:
Included enableMarketSalesDate as a query parameter in request of all endpoints.
Included enableMarketSalesDate as a query parameter in all endpoints. It is an optional boolean parameter, when set to true, it indicates that products for the range of sale start date - 56 days to sale end date + 175 days, should be considered in the response. Please refer to the API specification for details.
Sorted retailUnits in the response
Retail Units in the response are sorted in all endpoints.
Removed:
Removed ignoreSaleDates as a query parameter in request of all endpoints.
Removed ignoreSaleDates as a query parameter in all endpoints.
2024-10-24
Added
New addons relations.
New add-ons relation completes and addsCoordination has been added.
Changed
Improved filter for rugs
Underlay rugs add-ons related to the rugs are more fine grained using filter on measurements percentage.
2024-06-10
Removed
Removed itemIdentifier field from response schema of all endpoints.
Removed the itemIdentifier field from response schema of all endpoints since it contained redundant information.
2024-04-07
Added
Added filter to ignore sale dates.
Implemented a query parameter named “ignoreSaleDates” to retrieve product add-ons ignoring the sale dates filter. This filter has been integrated into all API endpoints. Refer to the API specification for usage guidelines.
2024-03-04
Added
Added “retailUnits” as response field
Introduced the “retailUnits” field within the product payload to denote the retail units where the product is available.
Added
Added filter on retail-units.
Implemented a query parameter named “retailUnits” to retrieve product add-ons based on the specified retail units. This filter has been integrated into all API endpoints. Refer to the API specification for usage guidelines.
2023-07-27
Changed
Removed item type from products IRI
Previously product identifier is formed as “product item type - product item number” for example, ART-12345678, now the product identifier is formed by taking only the product item number for example., 12345678. Currently, the change in the IRI does not impact the API consumers. However, 3 months from today 2023-07-27 we want to remove the itemIdentifier field.
2023-06-07
Added
Get add-ons for multiple products
Added an endpoint to return the list of product add-ons associated with one or more products specified as input (via a comma-separated list of product numbers). Please refer to the API specification on how to use this functionality.
2023-06-02
Added
Get add-ons for planners
Added endpoint that given a list of products, it tries to find common characteristics, such that a list of addons that fits the input set can be created. Please refer to the API specification on how to use this functionality.
2023-05-29
Added
SPR enrichment
SPR product data that is fetched using PI (Product information) API does not have a family name, style group, and price class. Family name, style group and price class data are required to perform the ranking of add-ons for the input product. To support this, SPR product data are enriched for these HFBs (Home Furnishing Business): HFB01, HFB02, HFB03, HFB05, and HFB08. Now, it is possible to rank the add-ons for SPR products for the supported HFBs. This is ongoing work; the data will be updated to cover more HFBs.
Limiting result per main product type result
A product may have a lot of add-on products. A possibility to limit the result per main product is added. Please refer to the API specification on how to use this functionality.
Changed
Improved sorting version 2
HFBs (Home Furnishing Business) connected to add-ons in version 1 are HFB01, HFB02, HFB03, HFB04, HFB05, and HFB08. The modeling for these HFBs is updated partially to have more accurate add-ons for an input product.
The add-ons relevancy ranking order logic is updated. Now the ranking is calculated by combining the family name score, style group score, and price class score.
Explore the Add-ons live demo
Search for a main product using its product identifier, and get its list of add-ons.