快速开始

基础地址：

GET https://meiguodizhionline.com/api/public/v1/address?country=US&count=1

固定 Seed 的加利福尼亚测试数据：

curl "https://meiguodizhionline.com/api/public/v1/address?country=US&region=CA&count=10&seed=checkout-demo"

直接查看 JSON 响应

请求参数

参数说明示例
countryISO 3166-1 两位国家代码，默认 USUS、JP、DE
region州、省或地区代码；留空时随机选择CA、JP-13
count返回数量，允许 1–1010
gender姓名选择：any、male、femaleany
seed最多 64 个字符；相同参数与 Seed 返回相同记录checkout-demo

JavaScript 示例

const response = await fetch('https://meiguodizhionline.com/api/public/v1/address?country=JP&count=2&seed=form-test');
const { meta, addresses } = await response.json();
console.log(meta.seed, addresses[0].formattedAddress);

返回字段

每条记录包含国家与地区代码、本地语言和 locale、姓名、测试邮箱、电话、街道、门牌号、Address Line 2、城市、行政区、邮编、格式顺序及本地化完整地址等 40 多个字段。所有记录均标记为 synthetic-unverified。

额度与升级

公开接口用于轻量开发和即时预览，按网络来源每分钟最多约 30 次请求。需要每日 20 条、最近批次记录时可以使用免费邮箱登录；批量生成、CSV/JSON 下载和云端保存由 Pro 提供。