Skip to main content
POST
/
api
/
hm
/
products
/
search
/hm/products/search
curl --request POST \
  --url https://api.anysite.io/api/hm/products/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 2,
  "timeout": 300,
  "locale": "en_us"
}
'
[
  {
    "id": "<string>",
    "@type": "@hm_product",
    "name": "<string>",
    "brand": "<string>",
    "url": "<string>",
    "alias": "<string>",
    "price": 123,
    "list_price": 123,
    "price_formatted": "<string>",
    "image": "<string>",
    "images": [],
    "color_name": "<string>",
    "colors": [],
    "sizes": [],
    "is_in_stock": true,
    "is_coming_soon": true,
    "is_new_arrival": true,
    "is_multipack": true,
    "has_video": true,
    "category": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
keyword
string
required

Search keyword

Minimum string length: 1
Example:

"floral dress"

count
integer
required

Max number of products to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
locale
enum<string>
default:en_us

H&M store locale

Available options:
en_us,
en_gb,
de_de,
fr_fr,
es_es,
it_it

Response

Successful Response

id
string
required
@type
string
default:@hm_product
name
string | null
brand
string | null
url
string | null
alias
string | null
price
number | null
list_price
number | null
price_formatted
string | null
image
string | null
images
string[]
color_name
string | null
colors
HmProductColor · object[]
sizes
HmProductSize · object[]
is_in_stock
boolean | null
is_coming_soon
boolean | null
is_new_arrival
boolean | null
is_multipack
boolean | null
has_video
boolean | null
category
string | null