H&M Countries API
Every H&M country with its region and the languages of its site.
GET /v1/hm/countries1 credit Failed requests are free
About this endpoint
GET /v1/hm/countries returns data.countries[] and data.totalCount. A country carries code (two letters, such as CH), name, region (Europe, Asia and so on) onlineStore and languages[], each with code, locale (such as fr_ch), the site's label and onlineStore. onlineStore says whether H&M sells online there, so search and categories work for it. It takes no parameters.
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 Countries API FAQ
Can every country here be searched?
Only those with onlineStore true. The list includes countries served by H&M's partners, whose sites are separate. GET /v1/hm/search and GET /v1/hm/categories answer those with a 400 saying the market has no online store, and charge nothing.
How do I use a language with the other routes?
Pass the country code as country and the language code as language, for example country=CH&language=fr.
How much does the country list 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.