# Social Fetch API - H&M endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 8 documented H&M operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/hm/search Search H&M products Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/hm/search/get.mdx SDK: client.hm.searchProducts({ query: "jeans", country: "US" }) Parameters: - query (required, string) - What to search for, e.g. `jeans` or `linen shirt`. - sort (optional, string, enum: relevance | newest | price_low | price_high) - `relevance` (default), `newest` first, `price_low` (lowest price first) or `price_high`. - limit (optional, integer) - Products per page, 1 to 72. Default: 36. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. - country (optional, string) - Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/hm/search?query=jeans" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/hm/search/suggest List H&M search suggestions Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/hm/search/suggest/get.mdx SDK: client.hm.suggestSearches({ query: "dre" }) Parameters: - query (required, string) - The start of a search to complete, e.g. `dre`. - country (optional, string) - Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/hm/search/suggest?query=dre" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/hm/products/{id} Get H&M product Credit cost: 3 credits. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/hm/products/id/get.mdx SDK: client.hm.getProduct({ id: "1240531009", country: "US" }) Parameters: - id (required, string) - The 10-digit article id from the product page URL, e.g. `1240531009`. A product page URL is accepted too. - country (optional, string) - Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/hm/products/1240531009?country=US" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/hm/products/{id}/reviews List H&M product reviews Credit cost: 3 credits. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/hm/products/id/reviews/get.mdx SDK: client.hm.listProductReviews({ id: "1240531009", sort: "newest" }) Parameters: - id (required, string) - The 10-digit article id from the product page URL, e.g. `1240531009`. A product page URL is accepted too. - sort (optional, string, enum: newest | oldest | highest_rating | lowest_rating) - Order of the reviews: `newest` (default), `oldest`, `highest_rating` or `lowest_rating`. - limit (optional, integer) - Reviews per page, 1 to 100. Default: 20. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. - country (optional, string) - Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/hm/products/1240531009/reviews?sort=newest" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/hm/products/{id}/suppliers Get H&M product suppliers Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/hm/products/id/suppliers/get.mdx SDK: client.hm.getProductSuppliers({ id: "1337544001" }) Parameters: - id (required, string) - The 10-digit article id from the product page URL, e.g. `1337544001`. A product page URL is accepted too. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/hm/products/1337544001/suppliers" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/hm/categories List H&M categories Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/hm/categories/get.mdx SDK: client.hm.listCategories({ country: "US" }) Parameters: - country (optional, string) - Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/hm/categories?country=US" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/hm/countries List H&M countries and languages Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/hm/countries/get.mdx SDK: client.hm.listCountries() Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/hm/countries" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/hm/stores List H&M stores Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/hm/stores/get.mdx SDK: client.hm.listStores({ country: "GB" }) Parameters: - country (optional, string) - Two-letter country code of the H&M market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code of the market's site, e.g. `en` or `fr`. Default: the market's main language. - limit (optional, integer) - Stores per page, 1 to 200. Default: 100. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/hm/stores?country=GB" \ -H "x-api-key: YOUR_API_KEY"