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机器可读的接口描述（OpenAPI）
完整的 OpenAPI 3.1 描述文件放在 /openapi.json，包含全部参数取值、51 个州代码枚举、返回字段和错误码。可以直接导入 Postman、 Insomnia、Swagger UI，或者喂给代码生成器和 AI agent——本接口无需 API Key、无需注册， 拿到这个文件就能直接调用，不用先申请凭证。
另外两个给程序读的文件：/llms.txt 是站点概览，/llms-full.txt 是各国地址格式规则的完整版，/pricing.md 是价格与限制的结构化说明。
请求参数（全部可选）
| 参数 | 默认值 | 说明 |
|---|---|---|
| count | 1 | 返回条数，1~100 的整数 |
| type | us | 地址类型：us（美国）/ us_tax_free（美国免税州）/ hk（香港）/ cv（佛得角）/ tr（土耳其）/ jp（日本）/ gb（英国，也接受 uk）/ ph（菲律宾） |
| 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",
"unit": "Apt 12B",
"city": "San Francisco",
"state": "CA",
"stateName": "California",
"zipCode": "94107",
"country": "United States",
"fullAddress": "125 Maple St, San Francisco, CA 94107, United States"
}
]
}unit 是 Address Line 2（公寓/套房/单元号），不包含在 fullAddress 里； 香港与佛得角地址不生成该字段，返回空字符串；土耳其地址会返回 Daire（公寓房号）， 日本地址会返回建物名和部屋番号，英国返回 Flat 号，菲律宾返回 Unit 号。
streetShort 和 phoneAlt 目前只有日本地址会填：前者是日本人日常填表用的略式写法（神宮前3-5-12）， 后者是与所选城市市外局番一致的固定电话。其余类型这两个键恒定存在但为空字符串， 调用方不必按类型判断。
barangay 目前只有菲律宾地址会填。barangay 是菲律宾最基层的行政单位，在本地地址里是必写的一行—— 投递靠它而不是路名，所以它单独成一个字段而不是塞进 unit。其余类型该键恒定存在但为空字符串。
英国地址的 zipCode 分两段并以空格分隔：前半段（outward）逐条经 api.postcodes.io 校验为真实邮区，后半段（inward）是格式正确的随机值——真实 inward code 属于 Royal Mail PAF 授权数据，公开来源拿不到。
使用限制与说明
- 单次请求 count 上限 100；无需鉴权，但请合理使用，持续超高频调用可能被限流。
- 数据为格式正确的测试样例，门牌号随机组合，不验证真实可投递性。
- 禁止用于真实邮寄、冒充他人或规避任何平台的地区与身份校验。
- 底层的州/城市/邮编数据已开源（MIT）：us-address-sample-data，可直接在项目里离线使用。
- 接口返回结构如有变更会保持向后兼容；问题反馈：support@addressmock.com。
继续查看