H&M hub

H&M Search Suggestions API

Complete a partial query the way H&M's search box does, with suggested pages.

GET /v1/hm/search/suggest

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.