
订阅
网店
一个账户,一把 API 密钥放在请求头 X-API-Key 中,每笔订单下单时即核验地址。
- 在
/signup创建账户,密钥可在客户中心获取 - 免费试用 14 天,100 次验证,无需信用卡
- 之后选择 Starter 或 Pro,无合约期限,不自动扣款
POST /validateX-API-Key: <您的密钥>// 试用:100 次验证,14 天{"address": {"street": …, "zip": …}}
API邮政地址:美国、法国及海外省
按客户输入的原样发送地址。API 会返回标准化后的地址、GPS 坐标、可送达性,以及 0 到 1 的置信度。
试用 14 天,100 次验证,无需信用卡。或按次付费,每次 0.02 USDC,无需账户。
工作原理
无需维护地址库,也无需自写规则。客户输入地址时,调用 API 即可。
您的商店、脚本或智能体将街道、城市、州、邮编和国家,按客户输入的原样发送。
"street": "100 stewart st"
API 返回标准化地址、GPS 坐标、可送达性,以及 0 到 1 的置信度。
"line1": "100 Stewart Street"
地址确认无误,包裹即可发出。否则,发货前先与客户核实。已验证过的地址直接读取缓存,不会重复计费。
"deliverability": "residential"
实际场景


两种接入方式
两种方式返回的结果完全相同,只是接入和付费方式不同。

订阅
一个账户,一把 API 密钥放在请求头 X-API-Key 中,每笔订单下单时即核验地址。
/signup 创建账户,密钥可在客户中心获取POST /validateX-API-Key: <您的密钥>// 试用:100 次验证,14 天{"address": {"street": …, "zip": …}}

按次付费
无需账户。每次调用通过 x402 在 Base 网络上支付 0.02 USDC。
POST /validateX-PAYMENT: <x402 支付凭证>// 每次调用 0.02 USDC,Base 网络{"address": {"street": …, "zip": …}}
/mcp,工具为 validate_address,可免费发现/manifest、/llms.txt 和 /AGENTS.md,供您的智能体使用在线测试
每个 IP 地址每天可免费试用几次。美国、法国及海外省地址可核验;其他地区只做部分验证。
示例:100 stewart st · seattle · wa · 98101 · US
覆盖范围
美国地址由 USPS(DPV)核验;法国及海外省由国家地址库(BAN)核验。其他地区仍为部分验证。
degraded: true已定位地址的返回值。
residential1.0无 GPS 点时为 0.99commercial1.0unknown0.55invalid0.05