Hermes API endpoint
Use Crawlora's Hermès search API to extract supported public Hermes data as structured JSON. This page includes request parameters, cURL examples, response schema, error behavior, credit cost, and a Playground link for testing before integration.
/hermes/searchSearches the Hermès catalogue by keyword and returns a page of normalized products in the same shape as hermes-category. A query Hermès has no match for returns total 0 with an empty products array: Hermès itself renders unrelated fallback recommendations on a no-results page, and those are deliberately not returned as results. When Hermès applies its own spelling correction the corrected term is reported in results_for. Page size is fixed at 48 by Hermès and cannot be changed. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.
Request parameters are generated from the active endpoint catalog. Required values must be sent before Crawlora can call the upstream public web data source.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | Yes | Search keyword | ||
| locale | string | No | Market and language. One of: at_de, au_en, be_en, be_fr, br_pt, ca_en, ca_fr, ch_de, ch_fr, cz_en, de_de, dh_en, dk_en, es_es, fi_en, fr_fr, gr_en, hk_en, ie_en, it_it, jp_ja, kr_ko, lu_fr, mo_en, mx_es, my_en, nl_en, no_en, pl_en, pt_en, ri_en, se_en, sg_en, th_en, tw_zh, uk_en, us_en Allowed values: at_de, au_en, be_en, be_fr, br_pt, ca_en, ca_fr, ch_de, ch_fr, cz_en, de_de, dh_en, dk_en, es_es, fi_en, fr_fr, gr_en, hk_en, ie_en, it_it, jp_ja, kr_ko, lu_fr, mo_en, mx_es, my_en, nl_en, no_en, pl_en, pt_en, ri_en, se_en, sg_en, th_en, tw_zh, uk_en, us_en | ||
| page | integer | No | One-based result page; page size is fixed at 48. Page 1 is fully validated; pages beyond 1 are best-effort and provisional Minimum: 1. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/hermes/search?query=coffee&locale=at_de&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.
Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.
| Plan | Price | Included credits | Daily cap | Rate limit | Overage |
|---|---|---|---|---|---|
| Free | $0/mo | 2,000 | 500 daily credits | 5/min | No overage |
| Starter | $9/mo | 20,000 | 5,000 daily credits | 15/min | $0.75/1,000 overage credits when enabled |
| Growth | $29/mo | 100,000 | 25,000 daily credits | 45/min | $0.45/1,000 overage credits when enabled |
| Pro | $79/mo | 400,000 | No daily cap | 120/min | $0.30/1,000 overage credits |
| Business | $199/mo | 1,200,000 | No daily cap | 300/min | $0.20/1,000 overage credits |
| Enterprise | $499/mo | 5,000,000 | No daily cap | 1,000/min | $0.12/1,000 overage credits |
This endpoint is executed through Crawlora's managed scraping infrastructure.
Some targets require real browser execution because the data is loaded through JavaScript, dynamic rendering, or interaction-like browser behavior.
For supported endpoints, Crawlora can route requests through a managed browser cluster. This allows Crawlora to execute JavaScript, load dynamic content, apply browser-level request behavior, and normalize the rendered result into JSON.
You do not need to operate your own Playwright, Puppeteer, Chrome, proxy, queue, or retry infrastructure.
- **A query with no matches returns `total` 0 and an empty `products` array.** Hermès' own no-results page still renders around 18 unrelated recommendations; those are deliberately not returned, so an empty result is never disguised as a list of unrelated products. - `results_for` appears only when Hermès applied its own spelling correction and searched for a different term than the one supplied. - **Page 1 is fully validated; pages beyond 1 are best-effort and should be treated as provisional.** Hermès gates the paginated URL shape harder than the bare one — its own `robots.txt` disallows the parameter that carries the offset, so those URLs are never edge-cached and always reach the origin's bot defense. Measured on cold categories: page 1 passed 10/10 while page 2 was blocked 10/10 in the same run on the same backends. When a page beyond 1 cannot be fetched the endpoint returns an upstream error rather than silently returning page 1 again. - **Page size is fixed at 48 by Hermès and cannot be changed.** `page_size` always reports 48; a page past the end returns an empty `products` array with the real `total` still reported. - `price` is a bare number as Hermès publishes it; `currency` is the ISO-4217 code for the selected market. - `filters` are the facet groups Hermès offers for the query, and are informational — this endpoint does not currently accept facet filters as inputs. A no-results query returns no facet groups. Example response: ```json { "code": 200, "msg": "ok", "data": { "locale": "us_en", "query": "scarf", "total": 1078, "page": 1, "page_size": 48, "products": [ { "sku": "H004368S 04", "title": "La Nature en Voyage scarf 90", "url": "https://www.hermes.com/us/en/product/la-nature-en-voyage-scarf-90-H004368Sv04/", "slug": "la-nature-en-voyage-scarf-90", "price": 505, "currency": "USD", "price_type": "fixed", "color": "Blue", "colorless": false, "more_colors": true, "size": "", "product_code": "S1A1", "department_code": "S", "family_code": "S01", "division_code": "01", "in_stock": true, "in_store": false, "personalizable": false, "images": [ "https://assets.hermes.com/is/image/hermesproduct/004368S%2004_front_wm_1" ] } ], "filters": [] } } ```
Crawlora does not silently return bad data when the upstream page cannot be used.
| Status | Common failure case |
|---|---|
| 400 | Invalid input or missing required parameter |
| 429 | Plan or endpoint rate limit exceeded |
| 500 | Internal execution error |
| 502 | Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved |
When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
{
"code": 200,
"msg": "ok",
"data": {
"locale": "us_en",
"query": "scarf",
"total": 1078,
"page": 1,
"page_size": 48,
"products": [
{
"sku": "H004368S 04",
"title": "La Nature en Voyage scarf 90",
"url": "https://www.hermes.com/us/en/product/la-nature-en-voyage-scarf-90-H004368Sv04/",
"slug": "la-nature-en-voyage-scarf-90",
"price": 505,
"currency": "USD",
"price_type": "fixed",
"color": "Blue",
"colorless": false,
"more_colors": true,
"size": "",
"product_code": "S1A1",
"department_code": "S",
"family_code": "S01",
"division_code": "01",
"in_stock": true,
"in_store": false,
"personalizable": false,
"images": [
"https://assets.hermes.com/is/image/hermesproduct/004368S%2004_front_wm_1"
]
}
],
"filters": []
}
}Request schema
No body schema
Response schema
#/definitions/hermes.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | hermes.SearchResponse | No | ||||
| data.filters | array | No | ||||
| data.filters[].attribute | string | No | ||||
| data.filters[].name | string | No | ||||
| data.filters[].values | array | No | ||||
| data.filters[].values[].count | integer | No | ||||
| data.filters[].values[].name | string | No | ||||
| data.filters[].values[].value | string | No | ||||
| data.locale | string | No | ||||
| data.page | integer | No | ||||
| data.page_size | integer | No | ||||
| data.products | array | No | ||||
| data.products[].color | string | No | ||||
| data.products[].colorless | boolean | No | ||||
| data.products[].currency | string | No | ||||
| data.products[].department_code | string | No | ||||
| data.products[].division_code | string | No | ||||
| data.products[].family_code | string | No | ||||
| data.products[].images | array | No | ||||
| data.products[].in_stock | boolean | No | ||||
| data.products[].in_store | boolean | No | ||||
| data.products[].more_colors | boolean | No | ||||
| data.products[].personalizable | boolean | No | ||||
| data.products[].price | number | No | ||||
| data.products[].price_type | string | No | ||||
| data.products[].product_code | string | No | ||||
| data.products[].size | string | No | ||||
| data.products[].sku | string | No | ||||
| data.products[].slug | string | No | ||||
| data.products[].title | string | No | ||||
| data.products[].url | string | No | ||||
| data.query | string | No | ||||
| data.results_for | string | No | ResultsFor is the term Hermès actually searched for, which can differ from query when it applies its own spelling correction. Empty when upstream reports no correction. | |||
| data.total | integer | No | ||||
| msg | string | No | ok |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/hermes/search?query=coffee&locale=at_de&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.
Read Crawlora terms