--- title: "IKEA API: JSON data, 3 endpoints, 1 credit per call" description: "IKEA API for product search by country, product details by item number and store, and store lists for six countries as JSON. 1 credit per call." url: https://perceptlayer.com/apis/ikea --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / IKEA 1 credit per call 3 endpoints 18 datapoints # IKEA API IKEA API for product search by country, product details by item number and store, and store lists for six countries as JSON. 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below IKEA GET /v1/ikea/search?query=billy ``` { "success": true, "data": { "query": "billy", "country": "us", "page": 1, "page_size": 24, "sort": "RELEVANCE", "total": 115, "total_pages": 5, "items": [ { "item_number": "20522046", "item_number_global": "20522046", "item_type": "ART", "name": "BILLY", "type": "Bookcase", "size_text": "31 1/2x11x79 1/2 \"", "design_text": "white", "url": "https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1590272_pe1038911_s5.jpg", "images": [ { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1590272_pe1038911_s5.jpg", "alt": "A tall, white, rectangular BILLY bookcase with open shelves.", "type": "MAIN_PRODUCT_IMAGE" }, { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1237507_pe917999_s5.jpg", "alt": "Modern home office a white BILLY bookshelf, natural wood walls, and a grey office desk with a black chair.", "type": "FUNCTIONAL_PRODUCT_IMAGE" }, { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1424760_pe979354_s5.jpg", "alt": "A cosy green room with a BILLY bookshelf, filled with plants and books, accompanied by a wicker chair and curtains.", "type": "CONTEXT_PRODUCT_IMAGE" } ], "price": { "currency": "USD", "amount": 79, "tags": [ "LOWER_CURRENT_REGULAR_PRICE_IN_STORE" ], "offer": { "text": "IKEA Family members save in store only", "valid_from": "2026-11-10", "valid_to": "2026-12-24" } }, "rating": 4.5, "rating_count": 2124, "online_sellable": true, "last_chance": false, "categories": [ "Storage & organization", "Shelving furniture", "Bookshelves & bookcases" ], "colors": [ "white" ], "variants": [ { "item_number": "50508652", "url": "https://www.ikea.com/us/en/p/billy-bookcase-brown-walnut-effect-50508652/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-brown-walnut-effect__1590308_pe1038947_s5.jpg", "rating": 4.5, "rating_count": 2124 }, { "item_number": "80492782", "url": "https://www.ikea.com/us/en/p/billy-bookcase-dark-brown-oak-effect-80492782/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-dark-brown-oak-effect__1590282_pe1038921_s5.jpg", "rating": 4.5, "rating_count": 2124 }, { "item_number": "40477340", "url": "https://www.ikea.com/us/en/p/billy-bookcase-black-oak-effect-40477340/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-black-oak-effect__1590300_pe1038939_s5.jpg", "rating": 4.5, "rating_count": 2124 } ] }, { "item_number": "50522040", "item_number_global": "50522040", "item_type": "ART", "name": "BILLY", "type": "Bookcase", "size_text": "15 3/4x11x79 1/2 \"", "design_text": "white", "url": "https://www.ikea.com/us/en/p/billy-bookcase-white-50522040/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1590291_pe1038930_s5.jpg", "images": [ { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1590291_pe1038930_s5.jpg", "alt": "BILLY bookshelf: tall, off-white, multi-shelf, minimalist.", "type": "MAIN_PRODUCT_IMAGE" }, { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1237571_pe918025_s5.jpg", "alt": "Hallway a white BILLY bookcase, a black chair, green walls, and a picture frame with a baby.", "type": "FUNCTIONAL_PRODUCT_IMAGE" }, { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1237512_pe918001_s5.jpg", "alt": "Modern green home office with a BILLY white bookshelf, black chair, wooden desk, and black and white chequered floor.", "type": "FUNCTIONAL_PRODUCT_IMAGE" } ], "price": { "currency": "USD", "amount": 59 }, "rating": 4.7, "rating_count": 1673, "online_sellable": true, "last_chance": false, "categories": [ "Storage & organization", "Shelving furniture", "Bookshelves & bookcases" ], "colors": [ "white" ], "variants": [ { "item_number": "40594928", "url": "https://www.ikea.com/us/en/p/billy-bookcase-blue-40594928/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-blue__1590294_pe1038933_s5.jpg", "rating": 4.7, "rating_count": 1673 }, { "item_number": "70477334", "url": "https://www.ikea.com/us/en/p/billy-bookcase-black-oak-effect-70477334/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-black-oak-effect__1590314_pe1038953_s5.jpg", "rating": 4.7, "rating_count": 1673 }, { "item_number": "80508641", "url": "https://www.ikea.com/us/en/p/billy-bookcase-brown-walnut-effect-80508641/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-brown-walnut-effect__1590293_pe1038932_s5.jpg", "rating": 4.7, "rating_count": 1673 } ] }, { "item_number": "90522043", "item_number_global": "90522043", "item_type": "ART", "name": "BILLY", "type": "Bookcase", "size_text": "31 1/2x11x41 3/4 \"", "design_text": "white", "url": "https://www.ikea.com/us/en/p/billy-bookcase-white-90522043/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1590306_pe1038945_s5.jpg", "images": [ { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1590306_pe1038945_s5.jpg", "alt": "A white BILLY bookshelf, minimalist, with three open shelves, simple and clean design.", "type": "MAIN_PRODUCT_IMAGE" }, { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1237549_pe918011_s5.jpg", "alt": "Modern living room with BILLY bookcase, guitar, grey couch, pillows, window, and minimalist art.", "type": "FUNCTIONAL_PRODUCT_IMAGE" }, { "url": "https://www.ikea.com/us/en/images/products/billy-bookcase-white__1237515_pe918003_s5.jpg", "alt": "A serene bedroom with a BILLY white bookshelf storing books and decor, positioned between a bed and a desk with a black office chair.", "type": "FUNCTIONAL_PRODUCT_IMAGE" } ], "price": { "currency": "USD", "amount": 49 }, "rating": 4.5, "rating_count": 1043, "online_sellable": true, "last_chance": false, "categories": [ "Storage & organization", "Shelving furniture", "Bookshelves & bookcases" ], "colors": [ "white" ], "variants": [ { "item_number": "30508648", "url": "https://www.ikea.com/us/en/p/billy-bookcase-brown-walnut-effect-30508648/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-brown-walnut-effect__1590286_pe1038925_s5.jpg", "rating": 4.5, "rating_count": 1043 }, { "item_number": "90477385", "url": "https://www.ikea.com/us/en/p/billy-bookcase-oak-effect-90477385/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-oak-effect__1590275_pe1038914_s5.jpg", "rating": 4.5, "rating_count": 1043 }, { "item_number": "00477337", "url": "https://www.ikea.com/us/en/p/billy-bookcase-black-oak-effect-00477337/", "image_url": "https://www.ikea.com/us/en/images/products/billy-bookcase-black-oak-effect__1097107_pe864733_s5.jpg", "rating": 4.5, "rating_count": 1043 } ] } ], "sort_options": [ { "id": "RELEVANCE", "name": "Best match", "selected": true }, { "id": "PRICE_LOW_TO_HIGH", "name": "Price: low to high", "selected": false }, { "id": "PRICE_HIGH_TO_LOW", "name": "Price: high to low", "selected": false } ], "filters": [ { "id": "MEASUREMENT_BUCKETS", "name": "Size" }, { "id": "COLOR", "name": "Color" }, { "id": "TYPE", "name": "Type" } ] }, "meta": { "endpoint_family": "search", "request_id": "req_4036d26539cd4e7f842ee48e8f26ebbb", "credits_charged": 1, "credits_remaining": 1999 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | item\_number string | item\_number\_global string | item\_type string | name string | type string | size\_text string | design\_text string | url url | image\_url url | images object\[\] | price object | rating number | rating\_count integer | online\_sellable boolean | last\_chance boolean | categories string\[\] | colors string\[\] | variants object\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 20522046 | 20522046 | ART | BILLY | Bookcase | 31 1/2x11x79 1/2 " | white | https://www.ikea.com/us/en/p/billy-bookcase-white-20522046/ | https://www.ikea.com/us/en/images/products/billy-bookcase-white\_\_1590272\_pe1038911\_s5.jpg | \[3 items\] | {4 fields} | 4.5 | 2124 | true | false | \[3 items\] | \[1 item\] | \[3 items\] | | 2 | 50522040 | 50522040 | ART | BILLY | Bookcase | 15 3/4x11x79 1/2 " | white | https://www.ikea.com/us/en/p/billy-bookcase-white-50522040/ | https://www.ikea.com/us/en/images/products/billy-bookcase-white\_\_1590291\_pe1038930\_s5.jpg | \[3 items\] | {2 fields} | 4.7 | 1673 | true | false | \[3 items\] | \[1 item\] | \[3 items\] | | 3 | 90522043 | 90522043 | ART | BILLY | Bookcase | 31 1/2x11x41 3/4 " | white | https://www.ikea.com/us/en/p/billy-bookcase-white-90522043/ | https://www.ikea.com/us/en/images/products/billy-bookcase-white\_\_1590306\_pe1038945\_s5.jpg | \[3 items\] | {2 fields} | 4.5 | 1043 | true | false | \[3 items\] | \[1 item\] | \[3 items\] | Recorded from our API · 3 items shown · 18 datapoints per item GET /v1/ikea/search?query=billy 18 datapoints ### Identity - item\_type string - name string - type string ### Contact - url url - image\_url url ### Reputation - images object\[\] - rating number - rating\_count integer ### Price - price object ### Other - item\_number string - item\_number\_global string - size\_text string - design\_text string - online\_sellable boolean - last\_chance boolean - categories string\[\] - colors string\[\] - variants object\[\] Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/ikea/search?query=billy" \ -H "X-API-Key: $API_KEY" ``` IKEA · 3 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/ikea/product`](https://perceptlayer.com/apis/ikea/product) | none +4 optional | 1 credit | | [GET `/v1/ikea/search`](https://perceptlayer.com/apis/ikea/search) | `query` +4 optional | 1 credit | | [GET `/v1/ikea/stores`](https://perceptlayer.com/apis/ikea/stores) | none +1 optional | 1 credit | Overview ## About the IKEA API ## What you can get The IKEA API returns IKEA shop data as JSON through 3 endpoints. Each takes a `country` (us, de, gb, fr, ca or au). - **Search:** `search` takes a `query`, with `page`, `store_id` and `sort` (RELEVANCE, PRICE\_LOW\_TO\_HIGH, PRICE\_HIGH\_TO\_LOW, NEWEST, RATING, NAME\_ASCENDING or MOST\_POPULAR). - **Products:** `product` takes an `item_number` or a product `url`, with `store_id`. - **Stores:** `stores` lists a country's stores. The recorded search for "billy" in us returns `items`, each with `item_number`, `name`, `type`, `size_text`, `design_text`, `url`, `image_url`, `price` ( `amount` and `currency`), `rating`, `rating_count`, `online_sellable`, `last_chance`, `categories`, `colors` and `variants`. It also returns `total` (115 in that recording), `total_pages`, `sort_options` and `filters`. ## How a call works Search, then look up: `GET /v1/ikea/search?query=billy` with your key in the `X-API-Key` header. Each result carries an `item_number`; `GET /v1/ikea/product?item_number=20522046&store_id=153` returns that product for one store. `stores` lists the stores for a country. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) Use cases ### Track IKEA prices for a product list `Use the IKEA API to track IKEA prices for a product list` ### Compare one product's price across the six countries `Use the IKEA API to compare one product's price across the six countries` ### Check a product at a specific store with \`store\_id\` `` Use the IKEA API to check a product at a specific store with `store_id` `` ### Watch products marked \`last\_chance\` `` Use the IKEA API to watch products marked `last_chance` `` FAQ ## Questions **How much does the IKEA API cost?** Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I look up a product by its item number?** Yes. \`product\` takes an \`item\_number\`, such as 20522046, or a product \`url\`. **Do I need an IKEA account?** No. You call this IKEA API with your Perceptlayer key in the \`X-API-Key\` header, with no IKEA login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build an IKEA scraper instead?** You can, but an IKEA scraper is code you maintain: page changes break it, requests get blocked, and IKEA's terms govern how you collect data. The IKEA API gives you 3 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the IKEA API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)