H&M

List H&M search suggestions

List H&M search suggestions and suggested pages for the start of a query.

GET/v1/hm/search/suggest
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

The start of a search to complete, e.g. `dre`.

min 1 chars · max 100 chars

countrystringoptionalquery

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

languagestringoptionalquery

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

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

Response fields
21

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no suggestion is an empty list.

one of: found, not_found

dataquery
string

The text that was completed.

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

Suggested searches, best first.

dataqueries[]text
string

Suggested search.

Suggested campaign and category pages.

datacontent[]title
string

Title, e.g. `Party looks`.

datacontent[]url
stringnullable

Page URL.

datacontent[]imageUrl
stringnullable

Image URL where given.

datacontent[]type
stringnullable

Kind of page where given.

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/search/suggest?query=dre" \
  -H "x-api-key: YOUR_API_KEY"

Responses

H&M search suggestions and suggested pages.