World Product Codes

Classify any product into HS, HTS, UNSPSC, NAICS, TARIC, ISIC, SIC, and 8 more international codes — from text descriptions, barcodes, or images.

原始信息汇总

World Product Codes API 数据集概述

基本信息

• 数据集名称: World Product Codes
• 提供方: Brookside Consultancy
• 类别: Commerce
• API版本: 1.0.0 (current)

核心功能

World Product Codes 是一个产品分类API，可将物理产品描述、条形码（UPC / EAN / GTIN）和产品图像映射到11个全球分类系统中的结构化国际分类代码。

支持的分类系统包括:

• 海关与贸易: 协调制度 (HS)、美国协调关税表 (HTS)、欧盟TARIC (TARIC)
• 采购与供应链: 联合国标准产品与服务代码 (UNSPSC)
• 经济与产业活动: 国际标准产业分类 (ISIC)、北美产业分类系统 (NAICS)、欧盟产业分类统计 (NACE)、美国标准产业分类 (SIC)、英国标准产业分类 (SIC_UK)
• 统计: 国际贸易标准分类 (SITC)、主要产品分类 (CPC)

工作原理

提交产品描述（如"waterproof hiking boots with ankle support"）或原始条形码（如0049000006346），API将返回一个分类代码排名列表（每个标准一个），每个结果包含置信度分数、人类可读标签和模型的推理过程。

• 条形码输入: API根据Open Food Facts离线数据库（数千万产品）解析代码，并回退到UPCItemDB以获得更广泛的零售覆盖。
• 图像输入: 视觉模型在分类运行前提取可见文本、品牌和产品特征。

每个请求都经过三阶段管道处理：离线条形码解析、跨预索引分类表的并行全文搜索以检索每个标准的候选代码，以及一个基于LLM的阶段（使用Google Gemini，OpenAI作为自动后备）来选择最佳匹配代码。结果缓存在Redis和PostgreSQL中，以便即时提供重复查询。

主要特性

• 一次API调用覆盖11个国际产品分类标准。
• 通过一个统一端点支持文本、条形码和图像输入。
• 支持异步批量分类，每个作业最多1,000个产品，完成后通过Webhook推送。
• 每个结果提供置信度评分和needs_review标志，用于人工审核队列。
• 支持直接代码查找和跨所有11个分类数据库的全文搜索。
• 每个请求提供完整的审计日志：使用的提供商、缓存命中状态和处理时间。
• 支持JSON和XML响应格式。

目标用户

适用于海关经纪人、产品数据经理、采购和寻源团队、电子商务编目员、物流平台、贸易合规软件、ERP集成，以及任何需要大规模、准确、一致的国际产品分类的工作流程。

端点概览

1. 统一分类 (POST /v1/classify) 在description有效负载中传递字符串。可以是自然语言描述或条形码。API自动检测条形码并在分类前进行解析。

2. 图像分类 (POST /v1/classify/image) 直接从照片中提取分类。发送带有PNG或JPEG文件的multipart/form-data请求。

3. 批量异步处理 (POST /v1/classify/bulk) 单次提交最多1,000个项目。立即返回job_id。可通过GET /v1/jobs/{id}轮询完成状态，或设置Webhook。

4. 分类法查找与搜索

   • 查找: GET /v1/codes/{standard}/{code} (例如，/codes/hs/851610)
   • 搜索: GET /v1/codes/search?standard={id}&q={query} (使用快速的PostgreSQL全文搜索)
   • 列表: GET /v1/standards (返回11个受支持系统的权威信息和详情)

5. 审计与健康日志

   • GET /v1/audit: 跟踪API使用情况，包括缓存命中、延迟和输入字符串。支持?format=csv以便于导出。
   • GET /v1/health: 验证混合管道（AI + 缓存 + 数据库）是否完全正常运行。

可靠性与置信度评分

每个分类结果都包含一个confidence指标（0-100）和一个needs_review布尔值。

分数范围	含义	needs_review
90 - 100	高置信度。精确的措辞匹配或条形码已验证。	false
70 - 89	良好置信度。适用于一般分析。	false
40 - 69	输入不明确。AI做出了有根据的猜测。	true
0 - 39	低置信度。描述可能过于模糊。	true

最佳实践: 通过筛选needs_review: true的响应来构建人工介入工作流程。让API完成95%的重任，让您的合规团队只专注于边缘情况。

访问与限制

• 缓存: 结果被安全缓存。如果您（或全球任何人）之前对完全相同的描述/条形码进行分类，系统会立即从内存中检索，延迟成本为零。
• RapidAPI配额: 您通过RapidAPI代理层进行计费/限制。检查标准标头（X-RateLimit-Requests-*）以监控剩余额度。
• 批量限制: 向/bulk端点提交500个项目的数组仅计为1次请求，对于大型数据集极具成本效益。