# Alibaba Cloud Address Purification API

> Alibaba Cloud Address Purification API on Apizie: 9 endpoints (Corrects errors in address text entered by users, Extracts address segments from unstructured data, Extracts name segments from natural text, Extracts phone number segments from natural text, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-address-purification`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/address-purification
- Page: https://zieapi.vercel.app/api/cloud/aliyun-address-purification
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-address-purification/openapi.json

Alibaba Cloud OpenAPI for Address Purification (address-purification, version 2019-11-18). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Corrects errors in address text entered by users
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/correct-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |
| ServiceCode | string | yes | Fixed value: addrp |
| Text | string | yes | The text content |
| DefaultProvince | string | no | The default province |
| DefaultCity | string | no | The default city |
| DefaultDistrict | string | no | The default district |
| AppKey | string | yes | The AppKey of the project |

### Extracts address segments from unstructured data
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/extract-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |
| ServiceCode | string | yes | Fixed value: addrp |
| Text | string | yes | The text content |
| DefaultProvince | string | no | The default province |
| DefaultCity | string | no | The default city |
| DefaultDistrict | string | no | The default district |
| AppKey | string | yes | The AppKey of the project |

### Extracts name segments from natural text
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/extract-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |
| ServiceCode | string | yes | Fixed value: addrp |
| Text | string | yes | The text content |
| DefaultProvince | string | no | The default province |
| DefaultCity | string | no | The default city |
| DefaultDistrict | string | no | The default district |
| AppKey | string | yes | The project AppKey |

### Extracts phone number segments from natural text
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/extract-phone` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |
| ServiceCode | string | yes | Fixed value: addrp |
| Text | string | yes | The text content |
| DefaultProvince | string | no | The default province |
| DefaultCity | string | no | The default city |
| DefaultDistrict | string | no | The default district |
| AppKey | string | yes | The AppKey of the project |

### Identifies the four-level administrative divisions (province, city, district/county, and street/town) from…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/get-address-division-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |
| ServiceCode | string | yes | Fixed value: addrp |
| Text | string | yes | The text content |
| DefaultProvince | string | no | The default province |
| DefaultCity | string | no | The default city |
| DefaultDistrict | string | no | The default district |
| AppKey | string | yes | The AppKey of the project |

### Determines whether two addresses are the same address and returns the finest-granularity level at which the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/get-address-similarity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |
| ServiceCode | string | yes | Fixed value: addrp |
| Text | string | yes | The text content |
| DefaultProvince | string | no | The default province |
| DefaultCity | string | no | The default city |
| DefaultDistrict | string | no | The default district |
| AppKey | string | yes | The AppKey of the project |

### Returns the postal code that corresponds to a specified address
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/get-zipcode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |
| ServiceCode | string | yes | Fixed value: addrp |
| Text | string | yes | The text content |
| DefaultProvince | string | no | The default province |
| DefaultCity | string | no | The default city |
| DefaultDistrict | string | no | The default district |
| AppKey | string | yes | The AppKey of the project |

### Classifies an original address into hierarchical levels and supports auto-completion of province, city,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/structure-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |
| ServiceCode | string | yes | Fixed value: addrp |
| Text | string | yes | The text content |
| DefaultProvince | string | no | The default province |
| DefaultCity | string | no | The default city |
| DefaultDistrict | string | no | The default district |
| AppKey | string | yes | The AppKey of the project |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://address-purification.cn-hangzhou.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/correct-address" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Address Purification API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-address-purification/correct-address with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Address Purification API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Address Purification itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Address Purification API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-address-purification.

### What is the status of the Alibaba Cloud Address Purification API?
Needs your own provider key (bring your own key)