海关数据搜索

接口说明

  • 对海关数据进行搜索

API路径

/services/v4/rest/enterprise/impExpTradeRecords

GET请求方法

请求参数

字段 类型 是否必选 说明 示例
keywords string 搜索关键词,交易产品或海关编码,交易产品需输入至少2个字符,海关编码需至少6位海关编码
page int 分页参数-页码,默认为1,每页数量固定10条 1
matchField string 匹配字段:product(交易产品),hsCode(海关编码) product
tradeStartTime string 交易日期-开始时间,格式为 YYYY-MM-DD 2026-03-02
tradeEndTime string 交易日期-结束时间,格式为 YYYY-MM-DD 2026-04-02

注意:

  • 交易产品只支持英文搜索
  • 交易时间范围最多一个月

调用样例

https://${host}/services/v4/rest/enterprise/impExpTradeRecords?keywords=garments&matchField=product&page=1&tradeStartTime=2026-03-02&tradeEndTime=2026-04-02

JSON示例

{
  "error_code": 0,
  "success": true,
  "message": "",
  "data": {
    "total": 9, // 海关数据数量
    "items": [
      {
        "tradeDate": "2026-03-27", // 交易日期
        "tradeHS": [ // HS编码
          "940171"
        ],
        "tradeHSDesc": [ // HS编码说明
          "94:家具;寝具、褥垫、弹簧床垫、软座垫及类似的填充制品;未列名灯具及照明装置;发光标志、发光铭牌及类似品;活动房屋\n9401:坐具(包括能作床用的两用椅,但品目9402的货品除外)及其零件\n940171:带软垫的金属框架坐具"
        ],
        "buyerName": "Hangzhou Surui E Commerce Co Ltd", // 采购商名称
        "buyerCountry": "美国", // 采购商国家
        "buyerAddress": "75 Carter Drive", //采购商地址
        "supplierName": "Hangzhou Surui E Commerce Co Ltd", // 供应商名称
        "supplierCountry": "中国", // 供应商国家
        "supplierAddress": "1984 Mo Gan Shan Lu", // 供应商地址
        "importPort": "new york/newark area, newark, new jersey", // 进口港
        "exportPort": "yantian, china", // 出口港
        "quantity": "1404.0", // 数量
        "weight": "11353.00KG", // 重量
        "money": "", // 金额(美金)
        "customsDeclarationNum": "SJKHSPHN26010557", // 提单号
        "productDescription": "METAL HOLDERS PLASTICS STORAGE CASE CUSHION C OVERS TRASH CAN", // 交易产品说明
        "transportationMethod": "水路", // 运输方式
        "deliveryTerm": "CIF(Cost, Insurance and Freight)卖方负责将货物运输到目的港的费用和保险费,适用于海运" // 交货条款
      }
    ]
  }
}

返回错误代码以及处理方式

code 处理方式 说明
406 修改参数 参数有错误,需要查看接口文档修改参数
2002 修改参数 未查询到相关企业

错误代码参考 错误码定义

文档更新时间: 2026-05-14 12:33   作者:3413