H&M Search Suggestions API
Complete a partial query the way H&M's search box does, with suggested pages.
GET /v1/hm/search/suggest1 credit Failed requests are free
About this endpoint
GET /v1/hm/search/suggest returns data.queries[] (each a suggested search text, best first) and data.content[], the campaign and category pages H&M suggests, each with title, url, imageUrl and type. query is the start of a search, up to 100 characters; country and language pick the market.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
H&M Search Suggestions API FAQ
How many suggestions come back?
Usually up to five searches and a few pages. Text H&M has nothing for answers two empty lists.
Do suggestions differ by market?
Yes. Each market suggests in its own language from its own catalogue, so country=DE with query=hose suggests German searches.
Can I use the suggestions in a search?
Yes. Pass any queries[].text as query to GET /v1/hm/search in the same market.
How much does a suggestion request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.