---
title: "Discover IKEA category keys"
method: GET
path: "/ikea/categories"
tags: ["IKEA"]
---

# Discover IKEA category keys

`GET /ikea/categories`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/ikea/categories`
- Auth: API key in header `x-api-key`

Returns a page of IKEA's full category taxonomy, sourced from IKEA's own site navigation data: every top-level department and nested subcategory, with the key each one uses as ikea_category's own category input. key is IKEA's own category key (numeric, e.g. 20649, or a short alphanumeric department code, e.g. st001). parent_key is the immediate parent category's own key (empty for a top-level department); level is depth in the taxonomy tree, starting at 1. q optionally filters by a case-insensitive substring of name.

## Query parameters

- `q` string
- `country` string
- `language` string
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- IkeaCategoriesResponseDoc
  - `code` integer
  - `data` IkeaCategoriesResponse
    - `categories` IkeaCategoryEntry[]
      - `key` string
      - `level` integer: Level is this category's depth in the taxonomy tree: 1 for a top-level department, 2 for its direct children, and so on.
      - `name` string
      - `parent_key` string: ParentKey is the immediate parent category's own key, empty for a top-level department. Some categories are cross-listed under more than one parent in IKEA's own taxonomy (e.g. "Knobs and handles" under both PAX and BESTÅ) -- ParentKey records one such parent, not every one; see this file's doc comment.
      - `url` string
    - `country` string
    - `fetched_at` string
    - `has_next` boolean
    - `language` string
    - `page` integer
    - `page_size` integer
    - `source_url` string
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)