Docs menu

H&M API endpoint

Find nearby H&M physical stores API

Returns H&M physical retail store locations near a point: name, phone, full address, and coordinates. Either search, or both lat and lng, is required. search is a free-text zip code or place name that is first resolved to coordinates; if it does not resolve to any location, a well-formed empty result is returned rather than an error. lat and lng, when given directly, skip that resolution step. radius_meters is optional (1000 to 50000, defaults to 10000). A location with no stores within the radius returns a well-formed empty result rather than an error.

GETapiKey3 credits/requestH&Mhm.storesResponseDoc/hm/stores

Endpoint facts

Method: GET
API path: /hm/stores
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: H&M
Response schema: #/definitions/hm.storesResponseDoc

H&M Scraper API Try Find nearby H&M physical stores API in Playground H&M API documentation

How this endpoint behaves

Searches H&M's own physical retail store locator. Provide search (a free-text zip code or place name, resolved to coordinates first), or both lat and lng directly.

radius_meters is optional, in meters, 1000 to 50000, defaults to 10000.

Notable response behavior:

Each store includes its name, phone number, full street address, and coordinates.
lat/lng in the response always reflect the coordinates actually searched -- the caller's own values when given directly, or the coordinates resolved from search otherwise.
A search value that does not resolve to any location returns a well-formed empty result (count: 0, stores: []), not an error.
A location with no stores within the radius returns a well-formed empty result, not an error.

Live monitoring

Monitored request: GET /hm/stores?lat=41.8781&lng=-87.6298&radius_meters=15000
Checks passed, 7 days to 14 Oct 2026: 99.9%
Median response time: 1.76 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /hm/stores?lat=41.8781&lng=-87.6298&radius_meters=15000
Items in stores: 2
Fields filled in every checked item: 10
Fields empty in some or all items: 1

Field	Filled in, of 2 checked	Values in the sample
store_code	2
store_class	2	“Red”
name	2	“Roosevelt Collection” and 1 other value
phone	1
address	2
city	2	“Chicago”
state	2	“Illinois”
postal_code	2
country	2	“USA”
latitude	2
longitude	2

Request parameters

Parameter	Type	Required	Default	Description	Example
search	string	No		Free-text zip code or place name to resolve to coordinates	10001
lat	number	No		Latitude, requires lng	40.7128
lng	number	No		Longitude, requires lat	-74.006
radius_meters	integer	No	10000	Search radius in meters, 1000 to 50000, defaults to 10000	10000
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/hm/stores" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "lat": 41.8781,
    "lng": -87.6298,
    "radius_meters": 15000,
    "count": 2,
    "stores": [
      {
        "store_code": "US0181",
        "store_class": "Red",
        "name": "Roosevelt Collection",
        "phone": "+1-855-466-7467",
        "address": "150 W Roosevelt Rd",
        "city": "Chicago",
        "state": "Illinois",
        "postal_code": "60605",
        "country": "USA",
        "latitude": 41.868378,
        "longitude": -87.632216
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/hm.storesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	hm.StoreResponse	No
data.count	integer	No
data.fetched_at	string	No
data.lat	number	No
data.lng	number	No
data.radius_meters	integer	No
data.search	string	No
data.source_url	string	No
data.stores	array	No
data.stores[].address	string	No
data.stores[].city	string	No
data.stores[].country	string	No
data.stores[].latitude	number	No
data.stores[].longitude	number	No
data.stores[].name	string	No
data.stores[].phone	string	No
data.stores[].postal_code	string	No
data.stores[].state	string	No
data.stores[].store_class	string	No
data.stores[].store_code	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/hm/stores" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More H&M endpoint docs H&M Scraper API H&M Category Navigation API documentation H&M Category Listing API documentation Get an H&M product's full detail API documentation Get an H&M product's related items API documentation H&M Product Search API documentation Get H&M search-box suggestions API documentation

Open in Playground Back to group

Docs menu

H&M API endpoint

Find nearby H&M physical stores API

GETapiKey3 credits/requestH&Mhm.storesResponseDoc/hm/stores

Endpoint facts

Method: GET
API path: /hm/stores
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: H&M
Response schema: #/definitions/hm.storesResponseDoc

H&M Scraper API Try Find nearby H&M physical stores API in Playground H&M API documentation

How this endpoint behaves

Searches H&M's own physical retail store locator. Provide search (a free-text zip code or place name, resolved to coordinates first), or both lat and lng directly.

radius_meters is optional, in meters, 1000 to 50000, defaults to 10000.

Notable response behavior:

Each store includes its name, phone number, full street address, and coordinates.
lat/lng in the response always reflect the coordinates actually searched -- the caller's own values when given directly, or the coordinates resolved from search otherwise.
A search value that does not resolve to any location returns a well-formed empty result (count: 0, stores: []), not an error.
A location with no stores within the radius returns a well-formed empty result, not an error.

Live monitoring

Monitored request: GET /hm/stores?lat=41.8781&lng=-87.6298&radius_meters=15000
Checks passed, 7 days to 14 Oct 2026: 99.9%
Median response time: 1.76 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /hm/stores?lat=41.8781&lng=-87.6298&radius_meters=15000
Items in stores: 2
Fields filled in every checked item: 10
Fields empty in some or all items: 1

Field	Filled in, of 2 checked	Values in the sample
store_code	2
store_class	2	“Red”
name	2	“Roosevelt Collection” and 1 other value
phone	1
address	2
city	2	“Chicago”
state	2	“Illinois”
postal_code	2
country	2	“USA”
latitude	2
longitude	2

Request parameters

Parameter	Type	Required	Default	Description	Example
search	string	No		Free-text zip code or place name to resolve to coordinates	10001
lat	number	No		Latitude, requires lng	40.7128
lng	number	No		Longitude, requires lat	-74.006
radius_meters	integer	No	10000	Search radius in meters, 1000 to 50000, defaults to 10000	10000
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/hm/stores" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "lat": 41.8781,
    "lng": -87.6298,
    "radius_meters": 15000,
    "count": 2,
    "stores": [
      {
        "store_code": "US0181",
        "store_class": "Red",
        "name": "Roosevelt Collection",
        "phone": "+1-855-466-7467",
        "address": "150 W Roosevelt Rd",
        "city": "Chicago",
        "state": "Illinois",
        "postal_code": "60605",
        "country": "USA",
        "latitude": 41.868378,
        "longitude": -87.632216
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/hm.storesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	hm.StoreResponse	No
data.count	integer	No
data.fetched_at	string	No
data.lat	number	No
data.lng	number	No
data.radius_meters	integer	No
data.search	string	No
data.source_url	string	No
data.stores	array	No
data.stores[].address	string	No
data.stores[].city	string	No
data.stores[].country	string	No
data.stores[].latitude	number	No
data.stores[].longitude	number	No
data.stores[].name	string	No
data.stores[].phone	string	No
data.stores[].postal_code	string	No
data.stores[].state	string	No
data.stores[].store_class	string	No
data.stores[].store_code	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/hm/stores" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Find nearby H&M physical stores API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Find nearby H&M physical stores API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related