Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / IKEA

1 credit per call3 endpoints18 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 keyRun 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 OKJSONX-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_numberstringitem_number_globalstringitem_typestringnamestringtypestringsize_textstringdesign_textstringurlurlimage_urlurlimagesobject[]priceobjectratingnumberrating_countintegeronline_sellablebooleanlast_chancebooleancategoriesstring[]colorsstring[]variantsobject[]
12052204620522046ARTBILLYBookcase31 1/2x11x79 1/2 "whitehttps://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.52124truefalse[3 items][1 item][3 items]
25052204050522040ARTBILLYBookcase15 3/4x11x79 1/2 "whitehttps://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.71673truefalse[3 items][1 item][3 items]
39052204390522043ARTBILLYBookcase31 1/2x11x41 3/4 "whitehttps://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.51043truefalse[3 items][1 item][3 items]

Recorded from our API · 3 items shown · 18 datapoints per itemGET /v1/ikea/search?query=billy

18 datapoints

Identity

  • item_typestring
  • namestring
  • typestring

Contact

  • urlurl
  • image_urlurl

Reputation

  • imagesobject[]
  • ratingnumber
  • rating_countinteger

Price

  • priceobject

Other

  • item_numberstring
  • item_number_globalstring
  • size_textstring
  • design_textstring
  • online_sellableboolean
  • last_chanceboolean
  • categoriesstring[]
  • colorsstring[]
  • variantsobject[]

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/ikea/product
none+4 optional
1 credit
GET/v1/ikea/search
query+4 optional
1 credit
GET/v1/ikea/stores
none+1 optional
1 credit

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

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 keyRead the docs