H&M

H&M Stores API

H&M stores of one country, on 46 markets: store code, name, status, store class, address, city, state, postal code, coordinates, phone, weekly opening hours, dated exceptions, departments with their concepts and campaigns, filtered by city, postal code or a radius around a point (nearest first, with the distance), paged. Pass a store code to search to list that store's assortment. Costs 1 credit per request.

POST/api/v1/hm/stores

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

countrystringdefault:us

The H&M market, as a lowercase country code. This endpoint serves 46 countries: every market except mo (H&M lists no stores in Macau). Prices come back in the market's currency, never converted; every answer echoes country, language, currency, locale and store. ae, eg, id, th, br and cn (H&M runs a separate site there), al, az, ba, by, cl, co, cr, ge, is, kh, kz, mk, nz, pe, xk and za (no H&M online store), ru, and uk (send gb) answer 400, not charged.

Example: us

us — United States, USD, en (English). The default.
ca — Canada, CAD, en (English) or fr (French); default en.
mx — Mexico, MXN, es (Spanish).
gb — United Kingdom, GBP, en (English).
ie — Ireland, EUR, en (English).
de — Germany, EUR, de (German).
at — Austria, EUR, de (German).
ch — Switzerland, CHF, de (German) or fr (French) or it (Italian); default de.
fr — France, EUR, fr (French).
be — Belgium, EUR, nl (Dutch) or fr (French); default nl.
nl — Netherlands, EUR, nl (Dutch).
it — Italy, EUR, it (Italian).
es — Spain, EUR, es (Spanish).
pt — Portugal, EUR, pt (Portuguese).
se — Sweden, SEK, sv (Swedish).
fi — Finland, EUR, fi (Finnish) or sv (Swedish); default fi.
dk — Denmark, DKK, da (Danish).
no — Norway, NOK, no (Norwegian).
pl — Poland, PLN, pl (Polish).
cz — Czechia, CZK, cs (Czech).
sk — Slovakia, EUR, sk (Slovak).
hu — Hungary, HUF, hu (Hungarian).
ro — Romania, RON, ro (Romanian).
bg — Bulgaria, EUR, bg (Bulgarian).
gr — Greece, EUR, el (Greek).
rs — Serbia, RSD, sr (Serbian).
tr — Turkey, TRY, tr (Turkish).
ua — Ukraine, UAH, uk (Ukrainian).
il — Israel, ILS, he (Hebrew).
hk — Hong Kong, HKD, zh (Chinese) or en (English); default zh.
tw — Taiwan, TWD, zh (Chinese) or en (English); default zh.
jp — Japan, JPY, ja (Japanese).
kr — South Korea, KRW, ko (Korean).
in — India, INR, en (English).
my — Malaysia, MYR, en (English).
ph — Philippines, PHP, en (English).
sg — Singapore, SGD, en (English).
vn — Vietnam, VND, vi (Vietnamese).
au — Australia, AUD, en (English).
hr — Croatia, EUR, en (English); H&M's shared English EUR store (store "eu").
cy — Cyprus, EUR, en (English); H&M's shared English EUR store (store "eu").
ee — Estonia, EUR, en (English); H&M's shared English EUR store (store "eu").
lv — Latvia, EUR, en (English); H&M's shared English EUR store (store "eu").
lt — Lithuania, EUR, en (English); H&M's shared English EUR store (store "eu").
lu — Luxembourg, EUR, en (English); H&M's shared English EUR store (store "eu").
si — Slovenia, EUR, en (English); H&M's shared English EUR store (store "eu").

citystring

Only stores whose city or address contains this (case and accents ignored).

Example: New York

postal_codestring

Only stores whose postal code starts with this.

Example: 10003

latnumber

Latitude: stores within radius_km, nearest first, each with distance_km. Send with lng.

Example: 40.7386

lngnumber

Longitude (with lat).

Example: -73.9915

radius_kmnumberdefault:25

Radius around lat / lng in km, 0.1 to 1000.

Example: 10

pageintegerdefault:1

Results page, 1-based, up to 100.

Example: 2

page_sizeintegerdefault:20

Stores per page, 1 to 100.

Example: 50

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=120)

r = client.hm.stores(country="us", city="New York")["data"]
print(r["total"], "of", r["country_total"], "US stores")
for s in r["stores"]:
    print(s["store_code"], s["name"], s["address"], s["postal_code"], s["opening_hours"][0])

Response

"count": 10,

"total": 10,

"country_total": 478,

"page": 1,

"page_size": 20,

"total_pages": 1,

"country": "us",

"language": "en",

"currency": "USD",

"locale": "en_us",

"store": "us",

"response_time": 8639

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) r = client.hm.stores(country="us", city="New York")["data"] print(r["total"], "of", r["country_total"], "US stores") for s in r["stores"]: print(s["store_code"], s["name"], s["address"], s["postal_code"], s["opening_hours"][0])