List H&M search suggestions
List H&M search suggestions and suggested pages for the start of a query.
Headers
Get your API keyAPI key (`sfk_...`)
The start of a search to complete, e.g. `dre`.
min 1 chars · max 100 chars
Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`.
Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language.
pattern: ^[a-z]{2}$
Endpoint-specific response payload.
Always `found`: no suggestion is an empty list.
one of: found, not_found
The text that was completed.
The H&M market the answer is for.
Two-letter country code, e.g. `US`.
Two-letter language code, e.g. `en`.
H&M's own name for the market's site, e.g. `en_us`.
ISO 4217 currency of the market, e.g. `USD`.
Suggested searches, best first.
Suggested search.
Suggested campaign and category pages.
Title, e.g. `Party looks`.
Page URL.
Image URL where given.
Kind of page where given.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.