# IKEA (/docs/ikea) Search IKEA US products with prices, reductions, ratings and images IKEA sells furniture and home goods. This endpoint searches the IKEA US store by keyword: each product's price in US dollars, the price before a reduction, the star rating with its ratings count and images. Every result uses the canonical `Product` shape, and the IKEA-only facts sit in `product.ext.ikea`. Base URL: `/v1/ikea/...` IKEA exposes 1 routes here. ## Quickstart ### Search the store Pass product keywords as `query`. Results come in IKEA's own order. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/ikea/search?query=desk%20chair" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "items": [ { "product": { "id": "30571531", "title": "MATCHSPEL Gaming chair Bomstad light gray", "price": { "current": 229.99, "original": 299.99, "currency": "USD" }, "rating": { "average": 3.8, "count": 417 }, "ext": { "ikea": { "item_no": "30571531", "discount_percent": 23 } } } } ] } } ``` ## Questions people ask ### How do I find reduced items? On a reduced item `product.price.original` is the price before the reduction and `product.ext.ikea.discount_percent` the reduction in percent. Otherwise `original` is null. ### What is the article number? `product.ext.ikea.item_no` is IKEA's eight-digit article number, the one printed on the item's page and label on ikea.com. ### Why do some items share a name? IKEA sells some items in sizes under one name. `product.ext.ikea.measure` names the size, for example `Medium` or `Large`, and `product.id` tells them apart. ## All endpoints **How far back and how deep** Each list returns one page at a time. Send `cursor` for the next page, or `max_items` or `max_pages` to collect several pages in one call. A page size appears only where it has been verified. [How paging works](/docs/pagination.md). | Path | Rows per page | Date window | One call collects | | --- | --- | --- | --- | | `/v1/ikea/search` | about 24 | none | up to 5,000 rows or 50 pages | ## Platform notes **The US store.** Prices are in US dollars from ikea.com/us. **Search pages with a cursor.** Pass the returned `cursor` for the next page; a page shorter than the rest is the last. ## Next steps - [Pagination](/docs/pagination.md): How list endpoints page. - [Errors](/docs/errors.md): What each status means and which ones are refunded.