Languages
Product text language is set with language in the API JSON body — not via Portal URL locale (/en vs /zh).
Prices are always CNY
The API does not accept currency and does not convert FX. Standard responses use original_currency and display_currency of CNY with the same amount in yuan. Convert on your side if needed.
Request field
| Field | Required | Default | Description |
|---|---|---|---|
language | No | en | Translation locale for titles, attributes, search results. |
Example
POST /v1/products/search{
"channel": "1688",
"keyword": "phone case",
"language": "ja",
"page": 1,
"page_size": 10
}Channel mappings
Full locale tables are in data/language-mappings.json. Summary:
1688 mapping
Official 1688 language enums (country). Simplified Chinese (zh / zh-CN / cn) is no longer supported upstream — Gateway falls back to en.
| You send | 1688 code | Note |
|---|---|---|
en | en | English |
ja | ja | Japanese |
ko | ko | Korean |
ru | ru | Russian |
vi | vi | Vietnamese |
fr | fr | French |
pt | pt | Portuguese |
zh-tw / zh_TW | zh-tw | Traditional Chinese |
es | es | Spanish |
id | id | Indonesian |
th | th | Thai |
Taobao mapping
| You send | IOP code | Note |
|---|---|---|
en | en | English |
vi | vi | Vietnamese |
ru | ru | Russian |
ko | ko | Korean |
ja | ja | Japanese |
zh / zh-CN / cn | cn | Chinese |
See Product search and Product detail for examples with language.
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days