跨境电商本地化 E-commerce Localization
专为跨境电商场景打造的翻译方案,覆盖商品标题、详情、评价、客服消息和平台适配。 Purpose-built translation for cross-border e-commerce — product titles, descriptions, reviews, customer service, and platform adaptation.
快速概览
Quick Overview
跨境电商本地化 API 专为全球电商场景优化,支持 Amazon、Shopee、Shopify、Lazada、Temu 等主流平台的商品标题、详情描述、用户评价、客服消息、平台政策和广告文案的全链路翻译。内置各平台字符限制、SEO 关键词优化、敏感词过滤、品牌名保护等能力。支持 1→N 一次性翻译为多个目标语言,大幅提升多站点上架效率。
The E-commerce Localization API is optimized for global e-commerce scenarios, supporting Amazon, Shopee, Shopify, Lazada, Temu and other major platforms. Covers product titles, descriptions, reviews, customer messages, store policies, and ad copy. Built-in features include platform character limits, SEO keyword optimization, sensitive word filtering, and brand name protection. Supports 1-to-N translation to multiple target languages in a single request for efficient multi-site listing.
认证方式 Authentication
所有 API 请求均需要在 HTTP 请求头中携带有效的 API Token 进行身份认证。请在 控制台 获取您的 Access Token。
All API requests require a valid API Token in the HTTP request header for authentication. Obtain your Access Token from the Console .
Authorization: Bearer {access_token}
请求头 Request Headers
Header Header 类型 Type 必填 Required 说明 Description
Authorizationstring required Bearer Token 认证信息 Bearer token authentication
Content-Typestring required 请求体格式,固定为 application/json Request body format; fixed to application/json
内容类型参考 Content Type Reference
content_type content_type 适用场景 Use Case 翻译特点 Translation Features
title商品标题 Product Title 自动适配平台字符限制,嵌入高搜索量关键词,精简冗余修饰词 Auto-adapts to platform char limits, embeds high-volume keywords, trims redundant modifiers
description商品详情 / 五点描述 Description / Bullet Points 保留 HTML 标签(如有),维持结构化排版,本地化度量单位 Preserves HTML tags, maintains structured layout, localizes measurement units
review用户评价 User Reviews 保留口语化/网络用语风格,正确处理包含表情符号和拼写错误的文本 Preserves colloquial/internet slang tone, handles emojis and typos gracefully
chat客服消息 Customer Service Chat 短文本实时翻译,支持尊称/敬语模式,保留占位符 {{name}} 等 Real-time short text translation, supports honorific modes, preserves placeholders like {{name}}
policy店铺政策 / 退货说明 Store Policy / Returns 法律合规导向翻译,术语一致性保证,适配当地消费者保护法规 Legally-compliant translation, terminology consistency, local consumer protection adaptation
ad_copy广告文案 Ad Copy 营销导向翻译,保留感召力,适配当地文化禁忌和热门营销用语 Marketing-oriented translation, maintains persuasive appeal, adapts to local cultural taboos and trending phrases
请求端点 Endpoint
POST /v1/ecommerce/localization
请求参数 Request Parameters
参数 Parameter 类型 Type 必填 Required 说明 Description
text string required 待翻译的电商文本,最长 5,000 字符 E-commerce text to translate; max 5,000 chars
content_type string required 内容类型:title / description / review / chat / policy / ad_copy,影响翻译风格和策略 Content type: title/description/review/chat/policy/ad_copy; affects translation style and strategy
source_lang string required 源语言代码,如 en、zh,支持 auto 自动检测 Source language code, e.g. en, zh; supports auto detection
target_langs string[] required 目标语言代码数组,如 ["zh","ja","de","fr","es"],最多 10 个 Target language code array, e.g. ["zh","ja","de","fr","es"]; max 10
platform string optional 目标平台:amazon / shopify / shopee / lazada / temu;启用平台规则校验 Target platform: amazon/shopify/shopee/lazada/temu; enables platform rule validation
seo_optimize boolean optional 是否进行 SEO 关键词优化(嵌入高搜索量本地关键词),默认 false Enable SEO keyword optimization (embed high-volume local keywords); default false
glossary_id string optional 关联术语库 ID,确保品牌名、产品词在各语言中翻译一致 Associated glossary ID for consistent brand/product term translation across languages
preserve_html boolean optional 是否保留原文中的 HTML 标签,默认 true(description 类型建议开启) Preserve HTML tags from source text; default true (recommended for description type)
category string optional 商品类目提示,如 electronics / fashion / home / beauty,辅助术语选择 Product category hint, e.g. electronics/fashion/home/beauty; aids terminology selection
protect_brand boolean optional 是否保护品牌名不被翻译,默认 true Protect brand names from being translated; default true
tone string optional 翻译语气:formal(正式)/ casual(轻松)/ professional(专业),默认根据 content_type 自动选择 Translation tone: formal/casual/professional; defaults based on content_type
响应字段 Response Fields
字段 Field 类型 Type 说明 Description
code integer 状态码,0 表示成功 Status code; 0 = success
message string 操作结果描述 Result description
data.original string 原始文本 Original text
data.translations object 以语言代码为 key 的翻译结果字典 Translation results keyed by language code
data.platform string 适配的平台(如请求中传入) Adapted platform (if provided in request)
data.content_type string 内容类型 Content type used
data.source_lang string 检测到的源语言(当 source_lang=auto 时) Detected source language (when source_lang=auto)
data.seo_keywords object 各语言的 SEO 推荐关键词列表(仅 seo_optimize=true 时返回) SEO keyword suggestions per language (only when seo_optimize=true)
data.warnings array 平台规则警告列表(如超长、敏感词等) Platform rule warnings (e.g. char overflow, sensitive terms)
data.char_count object 各语言翻译结果的字符数统计 Character count per language translation
请求示例 Request Examples
商品标题翻译(多语言 + SEO + 平台适配) Product Title (Multi-lang + SEO + Platform)
cURL
Python
JavaScript
Go
# 商品标题:多语言 + SEO + Amazon 平台适配
curl -X POST https://api.itranslator.cc/v1/ecommerce/localization \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"text": "Premium Wireless Bluetooth Headphones with Active Noise Cancellation, 30-Hour Battery Life, IPX5 Waterproof",
"content_type": "title",
"source_lang": "en",
"target_langs": ["zh","ja","de","fr","es"],
"platform": "amazon",
"seo_optimize": true,
"category": "electronics",
"protect_brand": true
}'
# 客服消息:中日互译 + 术语库
curl -X POST https://api.itranslator.cc/v1/ecommerce/localization \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"text": "亲爱的{{customer_name}},您的订单 #{{order_id}} 已发货,预计3-5个工作日送达。",
"content_type": "chat",
"source_lang": "zh",
"target_langs": ["ja","en","ko"],
"glossary_id": "gls_ecom_v1",
"tone": "formal"
}'
import requests
# 商品标题:多语言 + SEO
payload = {
"text": "Premium Wireless Bluetooth Headphones with Active Noise Cancellation, 30-Hour Battery Life, IPX5 Waterproof",
"content_type": "title",
"source_lang": "en",
"target_langs": ["zh","ja","de","fr","es"],
"platform": "amazon",
"seo_optimize": True,
"category": "electronics",
"protect_brand": True
}
resp = requests.post(
"https://api.itranslator.cc/v1/ecommerce/localization",
headers={"Authorization": f"Bearer {token}"},
json=payload
)
print(resp.json())
# 客服消息:模板消息翻译
payload2 = {
"text": "亲爱的{{customer_name}},您的订单 #{{order_id}} 已发货,预计3-5个工作日送达。",
"content_type": "chat",
"source_lang": "zh",
"target_langs": ["ja","en","ko"],
"glossary_id": "gls_ecom_v1",
"tone": "formal"
}
resp2 = requests.post(
"https://api.itranslator.cc/v1/ecommerce/localization",
headers={"Authorization": f"Bearer {token}"},
json=payload2
)
print(resp2.json())
// 商品标题:多语言 + SEO + 平台适配
const resp = await fetch(
"https://api.itranslator.cc/v1/ecommerce/localization", {
method: "POST",
headers: {
Authorization: `Bearer ${token}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
text: "Premium Wireless Bluetooth Headphones with Active Noise Cancellation, 30-Hour Battery Life, IPX5 Waterproof",
content_type: "title",
source_lang: "en",
target_langs: ["zh","ja","de","fr","es"],
platform: "amazon",
seo_optimize: true,
category: "electronics",
protect_brand: true
})
});
console.log(await resp.json());
// 商品详情:保留 HTML
const resp2 = await fetch(
"https://api.itranslator.cc/v1/ecommerce/localization", {
method: "POST",
headers: {
Authorization: `Bearer ${token}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
text: " Active Noise Cancellation 30H Battery ",
content_type: "description",
source_lang: "en",
target_langs: ["zh","ja","de"],
platform: "shopify",
preserve_html: true
})
});
console.log(await resp2.json());
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
payload := map[string]interface{}{
"text": "Premium Wireless Bluetooth Headphones with Active Noise Cancellation, 30-Hour Battery Life, IPX5 Waterproof",
"content_type": "title",
"source_lang": "en",
"target_langs": []string{"zh", "ja", "de", "fr", "es"},
"platform": "amazon",
"seo_optimize": true,
"category": "electronics",
"protect_brand": true,
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST",
"https://api.itranslator.cc/v1/ecommerce/localization",
bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
b, _ := io.ReadAll(resp.Body)
fmt.Println(string(b))
}
响应示例 Response Examples
示例 1:商品标题(多语言 + SEO + Amazon) Example 1: Product Title (Multi-lang + SEO + Amazon)
{
"code": 0,
"message": "success",
"data": {
"original": "Premium Wireless Bluetooth Headphones with Active Noise Cancellation, 30-Hour Battery Life, IPX5 Waterproof",
"content_type": "title",
"platform": "amazon",
"translations": {
"zh": "高端无线蓝牙耳机 主动降噪 30小时续航 IPX5防水 — 商务办公运动首选",
"ja": "【2026最新】プレミアムワイヤレスBluetoothヘッドホン アクティブノイズキャンセリング 30時間連続再生 IPX5防水",
"de": "Premium kabellose Bluetooth-Kopfhörer mit aktiver Geräuschunterdrückung, 30 Std Akku, IPX5 wasserdicht",
"fr": "Casque Bluetooth sans fil premium avec réduction de bruit active, autonomie 30h, étanche IPX5",
"es": "Auriculares Bluetooth inalámbricos premium con cancelación de ruido activa, batería 30h, resistente al agua IPX5"
},
"seo_keywords": {
"zh": ["蓝牙耳机","降噪耳机","无线耳机","防水耳机","长续航耳机"],
"ja": ["ワイヤレスヘッドホン","ノイズキャンセリング","Bluetooth","防水"],
"de": ["Bluetooth-Kopfhörer","Geräuschunterdrückung","kabellos","wasserdicht"],
"fr": ["casque Bluetooth","réduction de bruit","sans fil","étanche"],
"es": ["auriculares Bluetooth","cancelación de ruido","inalámbricos","resistente agua"]
},
"char_count": { "zh": 38, "ja": 49, "de": 64, "fr": 58, "es": 61 },
"warnings": []
}
}
示例 2:商品详情描述(HTML 保留 + Shopify) Example 2: Description (HTML Preserve + Shopify)
{
"code": 0,
"message": "success",
"data": {
"original": "<ul><li>Active Noise Cancellation (ANC)</li><li>30-Hour Battery Life</li><li>IPX5 Sweat & Water Resistant</li><li>Built-in Microphone</li></ul>",
"content_type": "description",
"platform": "shopify",
"translations": {
"zh": "<ul><li>主动降噪技术 (ANC)</li><li>30小时超长续航</li><li>IPX5 防汗防水等级</li><li>内置高清麦克风</li></ul>",
"ja": "<ul><li>アクティブノイズキャンセリング (ANC)</li><li>30時間バッテリー持続</li><li>IPX5防汗・防水対応</li><li>マイク内蔵</li></ul>",
"de": "<ul><li>Aktive Geräuschunterdrückung (ANC)</li><li>30 Stunden Akkulaufzeit</li><li>IPX5 schweiß- und wasserbeständig</li><li>Eingebautes Mikrofon</li></ul>"
},
"char_count": { "zh": 80, "ja": 72, "de": 96 },
"warnings": []
}
}
示例 3:客服消息(占位符保留 + 术语库) Example 3: Customer Chat (Placeholders + Glossary)
{
"code": 0,
"message": "success",
"data": {
"original": "亲爱的{{customer_name}},您的订单 #{{order_id}} 已发货,预计3-5个工作日送达。如有疑问请联系客服。",
"content_type": "chat",
"translations": {
"ja": "{{customer_name}}様、ご注文 #{{order_id}} は発送済みです。3~5営業日以内にお届け予定です。ご不明な点がございましたらカスタマーサポートまでお問い合わせください。",
"en": "Dear {{customer_name}}, your order #{{order_id}} has been shipped and is expected to arrive within 3-5 business days. Please contact customer support if you have any questions.",
"ko": "{{customer_name}}님, 주문 #{{order_id}}이(가) 발송되었습니다. 3~5영업일 이내에 도착 예정입니다. 문의사항이 있으시면 고객센터로 연락해 주세요."
},
"char_count": { "ja": 86, "en": 68, "ko": 79 },
"warnings": []
}
}
示例 4:广告文案(营销导向翻译) Example 4: Ad Copy (Marketing-Tuned)
{
"code": 0,
"message": "success",
"data": {
"original": "🔥 Flash Sale! 50% OFF All Summer Styles! Limited Time Only — Shop Now & Save Big!",
"content_type": "ad_copy",
"translations": {
"zh": "🔥 限时闪购!全场夏季新款低至 5 折!限量抢购,手慢无,立即下单享超值优惠!",
"ja": "🔥 タイムセール開催中!夏物全品50%OFF!期間限定—今すぐショップでお得にゲット!",
"de": "🔥 Blitzangebot! 50% RABATT auf alle Sommer-Styles! Nur für kurze Zeit — Jetzt shoppen & sparen!",
"fr": "🔥 Vente Flash ! -50% sur toute la collection été ! Offre limitée — Achetez maintenant et économisez !",
"es": "🔥 ¡Oferta Relámpago! ¡50% DE DESCUENTO en todos los estilos de verano! ¡Tiempo limitado — Compra ya y ahorra!"
},
"char_count": { "zh": 46, "ja": 48, "de": 58, "fr": 56, "es": 55 },
"warnings": []
}
}
示例 5:平台规则警告(标题超长) Example 5: Platform Warning (Title Too Long)
{
"code": 0,
"message": "success",
"data": {
"original": "Ultra-Comfortable Ergonomic Office Chair with Adjustable Lumbar Support, High-Density Memory Foam Cushion, Breathable Mesh Back, 3D Armrests, 360° Swivel, Heavy-Duty Base, BIFMA Certified",
"content_type": "title",
"platform": "shopee",
"translations": {
"zh": "超舒适人体工学办公椅 可调腰靠 高密度记忆棉座垫 透气网背 3D扶手 360°旋转 承重底座 BIFMA认证"
},
"char_count": { "zh": 55 },
"warnings": [
{
"language": "zh",
"rule": "title_max_length",
"platform_limit": 120,
"advice": "建议精简为 120 字符以内,当前 55 字符符合要求;但若结合品牌名和属性标签,建议控制在 100 字符以内以适配移动端展示"
}
]
}
}
平台规则适配 Platform Compliance
平台 Platform 标题限制 Title Limit 详情限制 Description Limit 特性 Features
Amazon 200 字符 2,000 字符 自动生成五点描述、品牌名保护、类目关键词建议 Auto bullet points, brand protection, category keyword suggestions
Shopify 70 字符 无上限 SEO meta title + description 双输出、结构化数据适配、HTML 标签保留 Dual SEO meta title/description output, structured data, HTML preservation
Shopee 120 字符 3,000 字符 关键词密度优化、Hashtag 标签生成、移动端标题截断提醒 Keyword density optimization, hashtag generation, mobile truncation alerts
Lazada 120 字符 3,000 字符 类目属性自动映射、长尾关键词挖掘、SKU 信息保留 Category attribute mapping, long-tail keyword mining, SKU info preservation
Temu 100 字符 1,000 字符 极致精简标题 + 属性标签、价格相关信息格式化、图片 alt 文本 Ultra-concise title + attribute tags, price formatting, image alt text
SEO 优化详解 SEO Optimization Details
当 seo_optimize=true 时,系统会针对每个目标语言进行以下优化:
When seo_optimize=true, the system applies the following optimizations per target language:
优化项 Optimization 说明 Description
关键词嵌入 Keyword Embedding 根据目标市场实时搜索趋势,将高搜索量本地关键词自然融入标题和五点描述 Embed high-volume local keywords naturally into titles and bullet points based on real-time market search trends
同义词扩展 Synonym Expansion 自动生成目标语言的同义变体关键词,覆盖不同搜索习惯的用户群体 Auto-generate synonym variant keywords per language to cover different search behaviors
字符效率优化 Character Efficiency 在平台字符限制内最大化关键词覆盖率,移除冗余修饰词但保留可读性 Maximize keyword coverage within platform char limits by removing redundant modifiers while keeping readability
本地搜索习惯适配 Local Search Adaptation 针对不同市场调整词序、拼写变体(美式/英式)、量词单位(如 inch→英寸/cm) Adjust word order, spelling variants (US/UK), and units (inch→cm) per market
违禁词过滤 Prohibited Term Filter 自动检测并替换目标平台/地区的违禁词和敏感表述,避免 Listing 被下架 Auto-detect and replace prohibited/sensitive terms per platform/region to avoid listing takedowns
商品类目提示 Category Hints
category 值 category Value 涵盖子类 Subcategories
electronics消费电子、手机配件、电脑外设、智能家居 Consumer electronics, phone accessories, peripherals, smart home
fashion服装、鞋履、箱包、配饰、珠宝 Apparel, footwear, bags, accessories, jewelry
home家居、厨房、园艺、家具、家纺 Home, kitchen, garden, furniture, textiles
beauty美妆、护肤、个护、香水、美发 Beauty, skincare, personal care, fragrance, haircare
sports运动户外、健身器材、露营、骑行 Sports, outdoor, fitness equipment, camping, cycling
toys玩具、婴童用品、益智教育 Toys, baby products, educational
pet宠物食品、宠物用品、宠物服饰 Pet food, supplies, apparel
使用限制 Usage Limits
限制项 Limit Item 上限 Cap 说明 Notes
单次文本长度 Text length 5,000 字符 chars 超出请分段调用 Split into multiple calls if exceeded
目标语言数量 Target languages 10 一次请求最多翻译至 10 种语言 Max 10 target languages per request
请求频率 Rate limit 60 次/分钟 req/min 批量上架建议使用批量接口 Use batch endpoint for bulk listings
术语库大小 Glossary size 10,000 条 entries 通过 glossary_id 关联的术语条目上限 Max glossary entries accessible via glossary_id
最佳实践 Best Practices
建议 Suggestion 说明 Description
建立品牌术语库
Build brand glossary
在 术语库 中注册品牌名、产品线名、材质/工艺专有名词,通过 glossary_id 在所有翻译请求中保持一致性
Register brand names, product lines, materials/process terms in Glossary ; use glossary_id for consistent translations across all requests
分类目制定翻译策略
Per-category strategy
不同品类的标题结构差异大——电子产品强调规格和参数,时尚类强调材质和风格。使用 category 参数引导翻译策略
Title structures vary by category — electronics emphasize specs, fashion emphasizes material/style. Use the category parameter to guide translation strategy
标题翻译务必传 platform
Always pass platform for titles
不同平台的标题字符限制差异极大(Temu 100 字 vs Amazon 200 字),不传 platform 可能生成不适合目标平台的超长标题
Title length limits vary greatly between platforms (Temu 100 vs Amazon 200 chars). Omitting platform may generate titles unsuitable for the target platform
开启 protect_brand 保护品牌名
Enable protect_brand
默认开启的品牌名保护可避免 Nike/Apple/Sony 等品牌被逐字翻译。若品牌在目标市场有官方译名,请通过术语库指定
Default brand protection prevents literal translation of brands like Nike/Apple/Sony. For markets with official brand translations, specify via glossary
评价翻译注意表情符号
Watch emojis in reviews
content_type=review 时会自动保留表情符号 💕 位置,并对口语化拼写错误进行语义理解后翻译,无需额外处理
content_type=review automatically preserves emoji positions and performs semantic understanding of colloquial typos before translating — no extra handling needed
批量上架使用异步模式
Use async for bulk listing
大批量 SKU(>100)翻译建议分批提交,每次 20~50 条,并监控用量避免触发频率限制
For large SKU batches (>100), submit in chunks of 20-50 items, and monitor usage to avoid rate limits
与其他 API 组合使用 Combination with Other APIs
组合场景 Combo Scenario 使用方式 Approach
术语库 + 跨境翻译
Glossary + E-commerce
先在 术语库 创建电商产品词库(品牌、型号、材质颜色等),再传入 glossary_id 保证多语言术语一致
Create e-commerce product term base in Glossary (brands, models, materials, colors), then pass glossary_id for consistent multi-language terms
语言识别 + 跨境翻译
Detect + E-commerce
批量处理未知语言的用户评价时,先用 语言识别 确定 source_lang,再送入跨境翻译
For batches of user reviews in unknown languages, detect source_lang first via Language Detection , then feed into e-commerce translation
图片翻译 + 跨境翻译
Image + E-commerce
商品主图中的文字用 图片翻译 识别并翻译后,与标题翻译结果组合输出完整 Listing
OCR text from product images via Image Translation , then combine with title/description translations for a complete listing
语法纠错 + 跨境翻译
Grammar + E-commerce
源文本(特别是用户评价)先用 语法纠错 修正拼写和语法问题,再传入翻译接口提高目标语言质量
Correct spelling and grammar in source text (especially reviews) via Grammar Check , then translate for higher target language quality
错误码 Error Codes
HTTP Code 错误码 Error Code 说明 Description
200 0成功 Success
400 1001参数错误,请检查必填参数和参数格式 Invalid parameter; check required fields and format
400 1002不支持的语言代码 Unsupported language code
400 1030无效的 content_type,仅支持 title/description/review/chat/policy/ad_copy Invalid content_type; only title/description/review/chat/policy/ad_copy supported
400 1031target_langs 数量超出上限(最多 10 个) target_langs exceeds max (10)
400 1032target_langs 中包含不支持的或重复的语言代码 target_langs contains unsupported or duplicate language codes
400 1033不支持的 platform,请查阅平台规则适配表 Unsupported platform; see platform compliance table
400 1034不支持的 category,请使用 electronics/fashion/home/beauty/sports/toys/pet Unsupported category; use electronics/fashion/home/beauty/sports/toys/pet
401 2001认证失败,Token 无效或已过期 Authentication failed; invalid or expired token
403 2003无权限访问该资源,或套餐不支持跨境电商功能 Access denied, or plan does not support e-commerce localization
413 3001请求文本超出长度限制(最大 5,000 字符) Text exceeds maximum length (5,000 chars)
429 4001请求频率超限,请稍后重试 Rate limit exceeded; please retry later
500 5001服务器内部错误,请重试或联系技术支持 Internal server error; retry or contact support
使用说明
Notes
跨境电商本地化接口返回的翻译已针对电商场景和平台规则做过优化,请勿再用通用的 文本翻译 接口处理电商内容。
E-commerce localization responses are already optimized for e-commerce and platform rules. Do not use the generic Text Translation for e-commerce content.
建议为不同站点创建独立的 术语库 ,例如美站术语库和日站术语库分别关联各自的商品本地化请求。
Create separate glossaries per marketplace (e.g. US vs JP) and link them to corresponding localization requests.
启用 SEO 优化会增加约 20%~30% 处理耗时,对实时性要求高的 chat 类型请按需关闭。
SEO optimization adds ~20%-30% processing time; disable it for latency-sensitive chat content.
平台规则仅作为翻译时的约束参考,最终上线前请人工复核目标平台的最新 Listing 规则。
Platform rules serve as translation constraints only; always review against the latest platform listing guidelines before publishing.