H&M hub

H&M Countries API

Every H&M country with its region and the languages of its site.

GET /v1/hm/countries

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

Request
cURL

Example response

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

Request
JSON

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.