Piloterr

IKEA Search

GET
/v2/ikea/search

Search IKEA products from a search URL and retrieve prices, ratings, dimensions, images, and pagination.

Credit cost: 1 credit per call

Authentification

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Paramètres de requête

query*string

Full IKEA search URL.

Example 1 (French search):

https://www.ikea.com/fr/fr/search/?q=meuble

Example 2 (page 2):

https://www.ikea.com/fr/fr/search/?q=meuble&page=2

Example 3 (UK search):

https://www.ikea.com/gb/en/search/?q=desk

Notes:

  • Only ikea.com /search/ URLs with a q parameter are accepted.
  • Copy the full URL from ikea.com, including country and language segments (/fr/fr/, /gb/en/, etc.).
  • Pagination via ?page=2 in the URL.
  • Use each result's url with the IKEA Product endpoint for full product data.
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corps de la réponse

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/ikea/search?query=string'
Example Response
{  "results": [    {      "id": "60282186",      "url": "https://www.ikea.com/fr/fr/p/lack-etagere-blanc-60282186/",      "image": "https://www.ikea.com/fr/fr/images/products/lack-etagere-blanc__0246565_pe385541_s5.jpg",      "price": "69,99€",      "title": "LACK",      "rating": 4.8,      "measure": "30x190 cm",      "currency": "EUR",      "subtitle": "Étagère",      "price_amount": 69.99,      "reviews_count": 327,      "online_sellable": true    },    {      "id": "20574587",      "url": "https://www.ikea.com/fr/fr/p/eket-element-2-portes-et-1-tablette-brun-motif-noyer-20574587/",      "image": "https://www.ikea.com/fr/fr/images/products/eket-element-2-portes-et-1-tablette-brun-motif-noyer__1373669_pe960035_s5.jpg",      "price": "105€",      "title": "EKET",      "rating": 3.3,      "measure": "70x35x70 cm",      "currency": "EUR",      "subtitle": "Élément 2 portes et 1 tablette",      "price_amount": 105,      "reviews_count": 184,      "online_sellable": true    },    {      "id": "80275887",      "url": "https://www.ikea.com/fr/fr/p/kallax-etagere-blanc-80275887/",      "image": "https://www.ikea.com/fr/fr/images/products/kallax-etagere-blanc__0644757_pe702939_s5.jpg",      "price": "74,99€",      "title": "KALLAX",      "rating": 4.7,      "measure": "77x147 cm",      "currency": "EUR",      "subtitle": "Étagère",      "price_amount": 74.99,      "reviews_count": 2742,      "online_sellable": true    }  ],  "pagination": {    "next": 2,    "current": 1,    "next_url": "https://www.ikea.com/fr/fr/search/?q=meuble&page=2",    "per_page": 24,    "total_count": 766,    "total_pages": 32,    "has_next_page": true  }}

IKEA Product GET

Précédent

ImmobilienScout24 Property GET

Suivant