Shipping Address Parser
Intelligently extract Chinese shipping recipient details from unstructured text: name, phone number, ID number, zip code, province/city/district, and detailed address. Supports single and batch processing (up to 200 entries/request) with deduplication by phone number or name.
Documentation
API Introduction
This API, based on natural language processing technology, can accurately extract key Chinese express delivery recipient information from unstructured mixed text. Core capabilities include automatically identifying and separating name, mobile number, ID card number (if any), postal code, and standard province/city/district/street detailed address.
Use Cases
- E-commerce Order Cleaning: Automatically standardize vague addresses manually entered by users, reducing shipping error rates.
- CRM Data Governance: Batch organize historical customer data and complete missing administrative division fields.
- Logistics System Integration: Real-time validation and structuring of address data during the order placement process to improve labeling efficiency.
Request and Response Description
- Request Method: POST
/v1/shipping-address-parse - Input Highlights:
addresses: String array, supports submitting up to 200 address texts per request.dedup: Optional deduplication strategy, supports filtering duplicate items by (mobile number) or .
Integration Examples
Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.
Request Example
{
"addresses": [
"张三 13800138000 广东省深圳市南山区科技园路 1 号 518000",
"李四 13900139000 北京市朝阳区建国路 88 号"
],
"dedup": "phone"
}Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"count": 2,
"originalCount": 2,
"removed": 0,
"items": [
{
"name": "张三",
"mobile": "13800138000",
"idn": null,
"postcode": "518000",
"province": "广东省",
"city": "深圳市",
"region": "南山区",
"street": "科技园路1号",
"original": "张三 13800138000 广东省深圳市南山区科技园路 1 号 518000"
},
{
"name": "李四",
"mobile": "13900139000",
"idn": null,
"postcode": null,
"province": "北京市",
"city": "北京市",
"region": "朝阳区",
"street": "建国路88号",
"original": "李四 13900139000 北京市朝阳区建国路 88 号"
}
]
}
}Request Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Sample |
|---|---|---|
| addresses | array | "张三 13800138000 广东省深圳市南山区科技园路 1 号 518000" |
| addresses[] | string | 张三 13800138000 广东省深圳市南山区科技园路 1 号 518000 |
| dedup | string | phone |
Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Sample |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.count | number | 2 |
| data.originalCount | number | 2 |
| data.removed | number | 0 |
| data.items | array | {"name":"张三","mobile":"13800138000","idn":null,"postcode":"518000","province":"广东省","city":"深圳市","region":"南山区","street":"科技园路1号","original":"张三 13800138000 广东省深圳市南山区科技园路 1 号 518000"} |