# IKEA Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/ikea/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/ikea-product |

## Description

Extract full IKEA product details from a product URL, including price, gallery, variants, dimensions, and breadcrumb.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/ikea/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup GLADHÖJDEN sit/stand desk on IKEA France

```json
{
  "id": "30493939",
  "url": "https://www.ikea.com/fr/fr/p/gladhoejden-bureau-assis-debout-blanc-30493939/",
  "image": "https://www.ikea.com/fr/fr/images/products/gladhoejden-bureau-assis-debout-blanc__1159429_pe888476_s5.jpg",
  "price": "149 €",
  "title": "GLADHÖJDEN Bureau assis/debout, blanc, 100x60 cm",
  "images": [
    "https://www.ikea.com/fr/fr/images/products/gladhoejden-bureau-assis-debout-blanc__1159429_pe888476_s5.jpg",
    "https://www.ikea.com/fr/fr/images/products/gladhoejden-bureau-assis-debout-blanc__1159428_pe888477_s5.jpg",
    "https://www.ikea.com/fr/fr/images/products/gladhoejden-bureau-assis-debout-blanc__1167477_pe891584_s5.jpg",
    "https://www.ikea.com/fr/fr/images/products/gladhoejden-bureau-assis-debout-blanc__1470516_pe996887_s5.jpg"
  ],
  "rating": 4.1,
  "measure": "100x60cm",
  "category": "Bureaux pour la maison",
  "currency": "€",
  "variants": [
    {
      "id": "30493939",
      "url": "https://www.ikea.com/fr/fr/p/gladhoejden-bureau-assis-debout-blanc-30493939/",
      "name": "Blanc",
      "image": "https://www.ikea.com/fr/fr/images/products/gladhoejden-bureau-assis-debout-blanc__1159429_pe888476_s5.jpg"
    },
    {
      "id": "20541610",
      "url": "https://www.ikea.com/fr/fr/p/gladhoejden-bureau-assis-debout-gris-clair-anthracite-20541610/",
      "name": "Gris clair/anthracite",
      "image": "https://www.ikea.com/fr/fr/images/products/gladhoejden-bureau-assis-debout-gris-clair-anthracite__1159426_pe888475_s5.jpg"
    }
  ],
  "breadcrumb": [
    {
      "url": "https://www.ikea.com/fr/fr/cat/produits-products/",
      "name": "Produits"
    },
    {
      "url": "https://www.ikea.com/fr/fr/cat/bureaux-chaises-de-bureau-fu004/",
      "name": "Bureaux & chaises de bureau"
    },
    {
      "url": "https://www.ikea.com/fr/fr/cat/bureaux-et-support-pc-tablettes-20649/",
      "name": "Bureaux et support PC/tablettes"
    },
    {
      "url": "https://www.ikea.com/fr/fr/cat/bureaux-pour-la-maison-20651/",
      "name": "Bureaux pour la maison"
    },
    {
      "url": null,
      "name": "GLADHÖJDENBureau assis/debout"
    }
  ],
  "dimensions": {
    "depth": "100 cm",
    "width": "10 kg",
    "height": "60 cm"
  },
  "description": "Vous travaillez depuis la maison ? Ce bureau assis/debout permet de passer la journée bien installé. Grâce un vérin à gaz, le bureau monte et descend facilement et en silence. Vous êtes ainsi toujours dans une bonne position de travail.",
  "price_amount": 149,
  "reviews_count": 9
}
```

## Documentation

## Overview
Extract full product details from any IKEA product page. Returns price, description, gallery, variants, breadcrumb, dimensions, rating, and category via website crawler.

IKEA product pages combine HTML product modules with JSON-LD metadata. Piloterr crawls the page, parses price, specs, images, color variants, and breadcrumb navigation, and returns structured JSON.

## Quickstart
```
GET https://api.piloterr.com/v2/ikea/product?query=https://www.ikea.com/fr/fr/p/gladhoejden-bureau-assis-debout-blanc-30493939/
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full IKEA `/p/` product URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | IKEA item number |
| `url` | string | Canonical product URL |
| `title` | string \| null | Full product title |
| `description` | string \| null | Product description |
| `category` | string \| null | Category from breadcrumb |
| `measure` | string \| null | Size reference |
| `price` | string \| null | Formatted price |
| `price_amount` | number \| null | Numeric price |
| `currency` | string \| null | Currency symbol or code |
| `rating` | number \| null | Average rating |
| `reviews_count` | integer \| null | Number of reviews |
| `image` | string \| null | Main image URL |
| `images` | array | Full photo gallery URLs |
| `dimensions` | object | Width, depth, height when available |
| `variants` | array | Color/style variants with URL and image |
| `variants[].id` | string \| null | Variant item number |
| `variants[].name` | string | Variant label |
| `variants[].url` | string \| null | Variant product URL |
| `breadcrumb` | array | Navigation breadcrumb trail |
| `breadcrumb[].name` | string | Breadcrumb label |
| `breadcrumb[].url` | string \| null | Breadcrumb URL |

## Notes
- Supports any ikea.com locale (`/fr/fr/`, `/gb/en/`, etc.).
- Variant picker colors appear under `variants`.
- `dimensions` keys may be partial depending on the product type.
- Bundle URLs ending with `-s{id}` are supported.

## Main use cases
- Extract full IKEA product specs for comparison or inventory tools
- Pull variant URLs and images for catalog enrichment
- Monitor individual product prices and ratings
- Build furniture datasets from public IKEA product pages