Free Address API
地址生成 API
免费、无需注册的测试地址接口：一次请求最多 100 条，城市、州、邮编严格匹配，JSON 返回并支持跨域。 适合自动化测试、种子数据和开发联调。网页端批量操作可以直接用批量生成工具。
TL;DR (English)
AddressMock offers a free fake address generator API — no API key, no signup, CORS enabled. Each request returns up to 100 sample US addresses as JSON with matched city, state, ZIP code and phone area code (the combination passes region-consistency validation). Hong Kong and Cape Verde addresses are also available via the type parameter. Addresses are format-correct test samples, not verified deliverable addresses.
curl "https://addressmock.com/api/addresses?count=10&state=CA"接口地址
GET https://addressmock.com/api/addresses请求参数（全部可选）
| 参数 | 默认值 | 说明 |
|---|---|---|
| count | 1 | 返回条数，1~100 的整数 |
| type | us | 地址类型：us（美国）/ us_tax_free（美国免税州）/ hk（香港）/ cv（佛得角） |
| state | 随机 | 美国州的两位缩写（如 CA、NY），仅 us / us_tax_free 有效 |
| city | 随机 | 城市名（如 Los Angeles），需与 state 配合使用 |
| gender | random | 姓名性别：random / male / female |
调用示例
curl
curl "https://addressmock.com/api/addresses?count=5&state=CA&gender=female"JavaScript
const res = await fetch(
"https://addressmock.com/api/addresses?count=10&type=us_tax_free"
);
const { results } = await res.json();
console.log(results[0].fullAddress);Python
import requests
r = requests.get(
"https://addressmock.com/api/addresses",
params={"count": 20, "state": "TX", "city": "Houston"},
)
for item in r.json()["results"]:
print(item["fullAddress"])返回示例
{
"count": 1,
"type": "us",
"results": [
{
"firstName": "Emily",
"lastName": "Carter",
"fullName": "Emily Carter",
"gender": "female",
"email": "emily.carter.42@example.com",
"phone": "(415) 555-0198",
"street": "125 Maple St",
"city": "San Francisco",
"state": "CA",
"stateName": "California",
"zipCode": "94107",
"country": "United States",
"fullAddress": "125 Maple St, San Francisco, CA 94107, United States"
}
]
}使用限制与说明
- 单次请求 count 上限 100；无需鉴权，但请合理使用，持续超高频调用可能被限流。
- 数据为格式正确的测试样例，门牌号随机组合，不验证真实可投递性。
- 禁止用于真实邮寄、冒充他人或规避任何平台的地区与身份校验。
- 底层的州/城市/邮编数据已开源（MIT）：us-address-sample-data，可直接在项目里离线使用。
- 接口返回结构如有变更会保持向后兼容；问题反馈：support@addressmock.com。
继续查看