SHEIN API endpoint
Returns SHEIN search suggestions for a partial query in the required `word`. Each suggestion has its `word`, `word_id` and `type`. A word with no matching phrase returns an empty list, not an error.
/shein/search/autocompleteQuery parameters:
word (required) — partial search query, e.g. dres.Response data.suggestions is an array of {word, word_id, type}. A
response with no suggestions for a non-empty word is a valid empty result
(no matching phrase), not an error.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| word | 20 | “Dresses For Woman” and 19 other values |
| word_id | 20 | |
| type | 20 | common (13), base_exp_channel (7) |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| word | string | Yes | Partial search query | dres | |
| x-api-key (header) | string | Yes | API key required |
curl -X POST "https://api.crawlora.net/api/v1/shein/search/autocomplete?word=dres" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"word": "dres",
"suggestions": [
{
"word": "Dress For Women",
"word_id": "163784",
"type": "common"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/shein.autocompleteResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | shein.AutocompleteResponse | No | ||||
| data.suggestions | array | No | ||||
| data.suggestions[].type | string | No | common | |||
| data.suggestions[].word | string | No | Dress For Women | |||
| data.suggestions[].word_id | string | No | 163784 | |||
| data.word | string | No | dres | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X POST "https://api.crawlora.net/api/v1/shein/search/autocomplete?word=dres" \
-H "x-api-key: $CRAWLORA_API_KEY"