Happy Endpoint

Get Categories list

Get categories ID list to be used in Search products by Category endpoint

GET
/categories

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

countryCode*string
  • Two-letter country code
  • Get available country codes from /countries endpoint
  • Examples: us (United States), ca (Canada), gb (United Kingdom), ch (Switzerland), se (Sweden), de (Germany)
Length2 <= length <= 2
languageCode*string
  • Two-letter language code
  • Get available language codes from /countries endpoint
  • Examples: en (English), fr (French), de (German), it (Italian), sv (Swedish)
  • Note: ca supports en or fr, ch supports de, fr, it, or en
Length2 <= length <= 2

Header Parameters

X-RapidAPI-Host*string
Default"ikea-api-pro.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/categories?countryCode=us&languageCode=en" \  -H "X-RapidAPI-Host: ikea-api-pro.p.rapidapi.com"
{
  "success": true,
  "data": {
    "categories": [
      {
        "id": "49155",
        "name": "Christmas tree ornaments & toppers",
        "url": "https://www.ikea.com/us/en/cat/tree-ornaments-accessories-49155/",
        "imageUrl": "https://www.ikea.com/global/assets/range-categorisation/images/product/tree-ornaments-accessories-49155.jpeg"
      }
    ]
  }
}
{
  "success": false,
  "message": "Invalid request: Keyword is required and must be a non-empty string",
  "error": "VALIDATION_ERROR"
}
{
  "success": false,
  "message": "The requested resource was not found for the specified country. Please verify your inputs.",
  "error": "RESOURCE_NOT_FOUND"
}
{
  "success": false,
  "message": "Internal server error. Please try again later.",
  "error": "INTERNAL_ERROR"
}
{
  "success": false,
  "message": "IKEA product search service is currently unavailable. Please try again later.",
  "error": "IKEA_API_ERROR"
}