H&M: Search
Search from H&M as JSON. 1 credit per successful call.
GET /v1/hm/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
query | string | Optional | Up to 100 characters |
category | string | Optional | Up to 300 characters |
locale | string | Optional | en_us, de_de, en_gb, fr_fr, sv_se, en_in, pl_pl, es_es |
page | integer | Optional | Any |
sort | string | Optional | RELEVANCE, NEWEST_FIRST, PRICE_ASCENDING, PRICE_DESCENDING |
filters | string | Optional | Any |
Example request
H&M
GET/v1/hm/search?query=jeans&locale=en_us&sort=PRICE_ASCENDING
{
"success": true,
"data": {
"query": "jeans",
"locale": "en_us",
"currency": "USD",
"page": 1,
"page_size": 36,
"sort": "PRICE_ASCENDING",
"total": 1335,
"total_pages": 38,
"items": [
{
"article_id": "1342508001",
"name": "Stretch Jeans",
"brand": "H&M",
"url": "https://www2.hm.com/en_us/productpage.1342508001.html",
"image_url": "https://image.hm.com/assets/hm/20/a9/20a9f743b1d23f1c732f1fbc1886d5bcd4ad3f15.jpg",
"model_image_url": "https://image.hm.com/assets/hm/20/a9/20a9f743b1d23f1c732f1fbc1886d5bcd4ad3f15.jpg",
"images": [
{
"url": "https://image.hm.com/assets/hm/31/4b/314b9463fc114d62bc5f35f9a5e112e6b76dcc52.jpg",
"type": "DescriptiveDetail"
},
{
"url": "https://image.hm.com/assets/hm/08/1f/081fbf910432bffdd8c6278d7bb459f51b8005c9.jpg",
"type": "DescriptiveDetail"
}
],
"price": 9.99,
"currency": "USD",
"member_price": 8.49,
"colour": "Dark denim blue",
"colour_code": "79829D",
"colour_shades": [
"Bright blue",
"Pastel blue",
"Blue gray"
],
"colours": [
{
"article_id": "1342508001",
"name": "Dark denim blue",
"code": "79829D",
"image_url": "https://image.hm.com/assets/hm/20/a9/20a9f743b1d23f1c732f1fbc1886d5bcd4ad3f15.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508001.html"
},
{
"article_id": "1342508002",
"name": "Light denim blue",
"code": "80AAD8",
"image_url": "https://image.hm.com/assets/hm/c8/02/c8020aa134dae2fce4f920e37714b019dfc4cb21.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508002.html"
},
{
"article_id": "1342508003",
"name": "Dark gray",
"code": "272627",
"image_url": "https://image.hm.com/assets/hm/f0/5d/f05dcec43d096118ea7d6e9a43453e372dedd392.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508003.html"
}
],
"sizes": [
{
"id": "004",
"label": "4-6M",
"availability": "in_stock"
},
{
"id": "005",
"label": "6-9M",
"availability": "in_stock"
},
{
"id": "006",
"label": "9-12M",
"availability": "in_stock"
}
],
"in_stock": true,
"coming_soon": false,
"category_code": "kids_baby_boy_clothing_trousersjeans_jeans",
"is_new": false,
"is_multipack": false,
"has_video": false
},
{
"article_id": "1342508002",
"name": "Stretch Jeans",
"brand": "H&M",
"url": "https://www2.hm.com/en_us/productpage.1342508002.html",
"image_url": "https://image.hm.com/assets/hm/c8/02/c8020aa134dae2fce4f920e37714b019dfc4cb21.jpg",
"model_image_url": "https://image.hm.com/assets/hm/c8/02/c8020aa134dae2fce4f920e37714b019dfc4cb21.jpg",
"images": [
{
"url": "https://image.hm.com/assets/hm/ed/8f/ed8f5bb2d31940b0e9e45a0237fbcd23365b4f04.jpg",
"type": "DescriptiveDetail"
},
{
"url": "https://image.hm.com/assets/hm/75/ee/75ee7a20dedc97a56b6e4cf8cbe433eec41d6c75.jpg",
"type": "DescriptiveDetail"
}
],
"price": 9.99,
"currency": "USD",
"member_price": 8.49,
"colour": "Light denim blue",
"colour_code": "80AAD8",
"colour_shades": [
"Bright blue",
"Pastel blue",
"Blue gray"
],
"colours": [
{
"article_id": "1342508002",
"name": "Light denim blue",
"code": "80AAD8",
"image_url": "https://image.hm.com/assets/hm/c8/02/c8020aa134dae2fce4f920e37714b019dfc4cb21.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508002.html"
},
{
"article_id": "1342508001",
"name": "Dark denim blue",
"code": "79829D",
"image_url": "https://image.hm.com/assets/hm/20/a9/20a9f743b1d23f1c732f1fbc1886d5bcd4ad3f15.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508001.html"
},
{
"article_id": "1342508003",
"name": "Dark gray",
"code": "272627",
"image_url": "https://image.hm.com/assets/hm/f0/5d/f05dcec43d096118ea7d6e9a43453e372dedd392.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508003.html"
}
],
"sizes": [
{
"id": "004",
"label": "4-6M",
"availability": "in_stock"
},
{
"id": "005",
"label": "6-9M",
"availability": "in_stock"
},
{
"id": "006",
"label": "9-12M",
"availability": "in_stock"
}
],
"in_stock": true,
"coming_soon": false,
"category_code": "kids_baby_boy_clothing_trousersjeans_jeans",
"is_new": false,
"is_multipack": false,
"has_video": false
},
{
"article_id": "1342508003",
"name": "Stretch Jeans",
"brand": "H&M",
"url": "https://www2.hm.com/en_us/productpage.1342508003.html",
"image_url": "https://image.hm.com/assets/hm/f0/5d/f05dcec43d096118ea7d6e9a43453e372dedd392.jpg",
"model_image_url": "https://image.hm.com/assets/hm/f0/5d/f05dcec43d096118ea7d6e9a43453e372dedd392.jpg",
"images": [
{
"url": "https://image.hm.com/assets/hm/e8/f2/e8f2066c01884c398ea3e41e2529c5fcbdd3cbcd.jpg",
"type": "DescriptiveDetail"
},
{
"url": "https://image.hm.com/assets/hm/2b/53/2b530a1bc3af44edb9ad868ff73a008120345e47.jpg",
"type": "DescriptiveDetail"
}
],
"price": 9.99,
"currency": "USD",
"member_price": 8.49,
"colour": "Dark gray",
"colour_code": "272627",
"colour_shades": [
"Charcoal"
],
"colours": [
{
"article_id": "1342508003",
"name": "Dark gray",
"code": "272627",
"image_url": "https://image.hm.com/assets/hm/f0/5d/f05dcec43d096118ea7d6e9a43453e372dedd392.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508003.html"
},
{
"article_id": "1342508001",
"name": "Dark denim blue",
"code": "79829D",
"image_url": "https://image.hm.com/assets/hm/20/a9/20a9f743b1d23f1c732f1fbc1886d5bcd4ad3f15.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508001.html"
},
{
"article_id": "1342508002",
"name": "Light denim blue",
"code": "80AAD8",
"image_url": "https://image.hm.com/assets/hm/c8/02/c8020aa134dae2fce4f920e37714b019dfc4cb21.jpg",
"url": "https://www2.hm.com/en_us/productpage.1342508002.html"
}
],
"sizes": [
{
"id": "004",
"label": "4-6M",
"availability": "in_stock"
},
{
"id": "005",
"label": "6-9M",
"availability": "in_stock"
},
{
"id": "006",
"label": "9-12M",
"availability": "in_stock"
}
],
"in_stock": true,
"coming_soon": false,
"category_code": "kids_baby_boy_clothing_trousersjeans_jeans",
"is_new": false,
"is_multipack": false,
"has_video": false
}
],
"sort_options": [
{
"id": "RELEVANCE",
"label": "Relevance"
},
{
"id": "NEWEST_FIRST",
"label": "New"
},
{
"id": "PRICE_ASCENDING",
"label": "Lowest price"
}
],
"filters": [
{
"id": "colorWithNames",
"name": "ColorWithNames",
"values": [
{
"value": "beige_f5f5dc",
"count": 32
},
{
"value": "black_000000",
"count": 175
},
{
"value": "blue_0000ff",
"count": 833
}
]
},
{
"id": "garmentLengths",
"name": "GarmentLengths",
"values": [
{
"value": "Ankle-length",
"count": 119
},
{
"value": "Extra-long legs",
"count": 52
},
{
"value": "Long",
"count": 1148
}
]
},
{
"id": "clothingStyles",
"name": "ClothingStyles",
"values": [
{
"value": "Baggy",
"count": 133
},
{
"value": "Balloon Leg",
"count": 49
},
{
"value": "Barrel Leg",
"count": 135
}
]
}
],
"suggestions": [
"jeans",
"jeans women",
"jeans men"
]
},
"meta": {
"endpoint_family": "search",
"request_id": "req_e45b859bc93548db892a1c14c56d9f7b",
"credits_charged": 1,
"credits_remaining": 1925
}
}200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.