跨境电商本地化E-commerce Localization

专为跨境电商场景打造的翻译方案,覆盖商品标题、详情、评价、客服消息和平台适配。Purpose-built translation for cross-border e-commerce — product titles, descriptions, reviews, customer service, and platform adaptation.

快速概览

跨境电商本地化 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

HeaderHeader类型Type必填Required说明Description
AuthorizationstringrequiredBearer Token 认证信息Bearer token authentication
Content-Typestringrequired请求体格式,固定为 application/jsonRequest body format; fixed to application/json

内容类型参考

Content Type Reference

content_typecontent_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
textstringrequired待翻译的电商文本,最长 5,000 字符E-commerce text to translate; max 5,000 chars
content_typestringrequired内容类型:title / description / review / chat / policy / ad_copy,影响翻译风格和策略Content type: title/description/review/chat/policy/ad_copy; affects translation style and strategy
source_langstringrequired源语言代码,如 enzh,支持 auto 自动检测Source language code, e.g. en, zh; supports auto detection
target_langsstring[]required目标语言代码数组,如 ["zh","ja","de","fr","es"],最多 10 个Target language code array, e.g. ["zh","ja","de","fr","es"]; max 10
platformstringoptional目标平台:amazon / shopify / shopee / lazada / temu;启用平台规则校验Target platform: amazon/shopify/shopee/lazada/temu; enables platform rule validation
seo_optimizebooleanoptional是否进行 SEO 关键词优化(嵌入高搜索量本地关键词),默认 falseEnable SEO keyword optimization (embed high-volume local keywords); default false
glossary_idstringoptional关联术语库 ID,确保品牌名、产品词在各语言中翻译一致Associated glossary ID for consistent brand/product term translation across languages
preserve_htmlbooleanoptional是否保留原文中的 HTML 标签,默认 true(description 类型建议开启)Preserve HTML tags from source text; default true (recommended for description type)
categorystringoptional商品类目提示,如 electronics / fashion / home / beauty,辅助术语选择Product category hint, e.g. electronics/fashion/home/beauty; aids terminology selection
protect_brandbooleanoptional是否保护品牌名不被翻译,默认 trueProtect brand names from being translated; default true
tonestringoptional翻译语气:formal(正式)/ casual(轻松)/ professional(专业),默认根据 content_type 自动选择Translation tone: formal/casual/professional; defaults based on content_type

响应字段

Response Fields

字段Field类型Type说明Description
codeinteger状态码,0 表示成功Status code; 0 = success
messagestring操作结果描述Result description
data.originalstring原始文本Original text
data.translationsobject以语言代码为 key 的翻译结果字典Translation results keyed by language code
data.platformstring适配的平台(如请求中传入)Adapted platform (if provided in request)
data.content_typestring内容类型Content type used
data.source_langstring检测到的源语言(当 source_lang=auto 时)Detected source language (when source_lang=auto)
data.seo_keywordsobject各语言的 SEO 推荐关键词列表(仅 seo_optimize=true 时返回)SEO keyword suggestions per language (only when seo_optimize=true)
data.warningsarray平台规则警告列表(如超长、敏感词等)Platform rule warnings (e.g. char overflow, sensitive terms)
data.char_countobject各语言翻译结果的字符数统计Character count per language translation

请求示例

Request Examples

商品标题翻译(多语言 + SEO + 平台适配)

Product Title (Multi-lang + SEO + Platform)

# 商品标题:多语言 + 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"
  }'

响应示例

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
Amazon200 字符2,000 字符自动生成五点描述、品牌名保护、类目关键词建议Auto bullet points, brand protection, category keyword suggestions
Shopify70 字符无上限SEO meta title + description 双输出、结构化数据适配、HTML 标签保留Dual SEO meta title/description output, structured data, HTML preservation
Shopee120 字符3,000 字符关键词密度优化、Hashtag 标签生成、移动端标题截断提醒Keyword density optimization, hashtag generation, mobile truncation alerts
Lazada120 字符3,000 字符类目属性自动映射、长尾关键词挖掘、SKU 信息保留Category attribute mapping, long-tail keyword mining, SKU info preservation
Temu100 字符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 length5,000 字符chars超出请分段调用Split into multiple calls if exceeded
目标语言数量Target languages10一次请求最多翻译至 10 种语言Max 10 target languages per request
请求频率Rate limit60 次/分钟req/min批量上架建议使用批量接口Use batch endpoint for bulk listings
术语库大小Glossary size10,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
2000成功Success
4001001参数错误,请检查必填参数和参数格式Invalid parameter; check required fields and format
4001002不支持的语言代码Unsupported language code
4001030无效的 content_type,仅支持 title/description/review/chat/policy/ad_copyInvalid content_type; only title/description/review/chat/policy/ad_copy supported
4001031target_langs 数量超出上限(最多 10 个)target_langs exceeds max (10)
4001032target_langs 中包含不支持的或重复的语言代码target_langs contains unsupported or duplicate language codes
4001033不支持的 platform,请查阅平台规则适配表Unsupported platform; see platform compliance table
4001034不支持的 category,请使用 electronics/fashion/home/beauty/sports/toys/petUnsupported category; use electronics/fashion/home/beauty/sports/toys/pet
4012001认证失败,Token 无效或已过期Authentication failed; invalid or expired token
4032003无权限访问该资源,或套餐不支持跨境电商功能Access denied, or plan does not support e-commerce localization
4133001请求文本超出长度限制(最大 5,000 字符)Text exceeds maximum length (5,000 chars)
4294001请求频率超限,请稍后重试Rate limit exceeded; please retry later
5005001服务器内部错误,请重试或联系技术支持Internal server error; retry or contact support
使用说明
  • 跨境电商本地化接口返回的翻译已针对电商场景和平台规则做过优化,请勿再用通用的 文本翻译 接口处理电商内容。
  • 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.