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

You send	1688 code	Note
`en`	`en`	English
`ja`	`ja`	Japanese
`ko`	`ko`	Korean
`ru`	`ru`	Russian
`uz`	`uz`	Uzbek
`ar`	`ar`	Arabic
`zh` / `zh-CN` / `cn`	`cn`	Chinese

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.