海关数据搜索
接口说明
- 对海关数据进行搜索
API路径
/services/v4/rest/enterprise/impExpTradeRecordsGET请求方法
请求参数
| 字段 | 类型 | 是否必选 | 说明 | 示例 |
|---|---|---|---|---|
| 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