H&M

List H&M stores

List H&M stores in a country with addresses, coordinates, opening hours and departments.

GET/v1/hm/stores
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
countrystringquery

Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`.

languagestringquery

Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language.

pattern: ^[a-z]{2}$

limitintegerquery

Stores per page, 1 to 200. Default: 100.

≥ 1 · ≤ 200

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 512 chars

Response fields
55

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: a market without stores is an empty list.

one of: found, not_found

The H&M market the answer is for.

datamarketcountry
string

Two-letter country code, e.g. `US`.

datamarketlanguage
string

Two-letter language code, e.g. `en`.

datamarketlocale
string

H&M's own name for the market's site, e.g. `en_us`.

datamarketcurrency
stringnullable

ISO 4217 currency of the market, e.g. `USD`.

datatotalCount
integer

Stores in the market.

Stores on this page.

datastores[]id
string

Store code, e.g. `US0007`.

datastores[]name
stringnullable

Store name.

datastores[]status
stringnullable

Store status, e.g. `OPEN`.

datastores[]storeClass
stringnullable

H&M's store class, e.g. `Red`.

datastores[]storeType
stringnullable

H&M's use type, e.g. `RE`.

datastores[]vendor
stringnullable

Brand, e.g. `H&M`.

datastores[]phone
stringnullable

Phone number.

Postal address.

datastores[]addressline1
stringnullable

Street address.

datastores[]addressline2
stringnullable

Second address line.

datastores[]addresscity
stringnullable

City.

datastores[]addressstate
stringnullable

State or region.

datastores[]addresspostalCode
stringnullable

Postal code.

datastores[]addresscountry
stringnullable

Country name.

datastores[]addresscountryCode
stringnullable

Two-letter country code.

datastores[]latitude
numbernullable

Latitude.

datastores[]longitude
numbernullable

Longitude.

datastores[]timeZoneIndex
integernullable

The store's time zone as H&M numbers it (Microsoft's time zone index: `85` is London and Dublin, `140` South Africa).

datastores[]openingDate
stringnullable

Opening date where set.

datastores[]closingDate
stringnullable

Closing date where set.

Weekly opening hours.

datastores[]openingHours[]day
integernullable

Day of the week, 1 (Monday) to 7.

datastores[]openingHours[]name
stringnullable

Day name, e.g. `Mon`.

datastores[]openingHours[]opens
stringnullable

Opening time, e.g. `09:00`.

datastores[]openingHours[]closes
stringnullable

Closing time, e.g. `17:30`.

Dates with other opening hours.

datastores[]openingHourExceptions[]date
string

Date, e.g. `2026-11-27`.

datastores[]openingHourExceptions[]closedAllDay
booleannullable

Whether closed all day.

datastores[]openingHourExceptions[]opens
stringnullable

Opening time that day.

datastores[]openingHourExceptions[]closes
stringnullable

Closing time that day.

Departments in the store.

datastores[]departments[]id
string

Department id.

datastores[]departments[]name
stringnullable

Department, e.g. `Ladies`.

Collections the department carries.

datastores[]departments[]concepts[]
stringoptional

Campaign collections the store carries now.

datastores[]campaigns[]
stringoptional

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/hm/stores?country=GB" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of H&M stores in one country.