US ZIP Code Demographics and Trade Area Data

US ZIP Code Demographics and Trade Area Data

原始信息汇总

US ZIP Code Demographics and Trade Area Data 数据集详情

数据集概述

该API提供覆盖美国所有陆地ZIP Code的人口、收入、住房、教育和就业统计数据，并将其与空间索引相结合，支持真实的空间搜索功能。数据来源于5年调查估计值（5-year survey estimates），并包含四年的历史数据发布。

核心特色

与传统每次仅返回单一ZIP Code数据记录的服务不同，该API支持：

• 查询半径内所有ZIP Code及其人口统计数据，并可筛选最小人口数或最小收入
• 一次调用获取整个商业区域的总量数据（人口、家庭数、收入总和）
• 按州排名最富有、最贫困、面积最大或最老龄的ZIP Code
• 并排比较两个ZIP Code的数据

覆盖的数据维度

数据类别	具体内容
人口	总人口、中位年龄、年龄分段（18岁以下、18-34、35-54、55-64、65岁以上）、人口密度（每平方英里）
收入	家庭收入中位数、人均收入、贫困率、七个收入区间（25,000以下至200,000以上）的家庭数量
住房	家庭数、住房单元数、自住/租赁占用情况、自住率、房屋价值中位数、租金中位数
工作与教育	劳动力、失业人数、失业率、25岁以上人口中拥有学士及以上学历的人数及比率
种族与族裔	白人族裔、黑人族裔、亚裔、西班牙裔人口数据
百分位排名	收入、房屋价值、人口和密度在全国及各州的百分位排名（0为最低，100为最高）
时间变化	四次发布版本之间的人口、家庭收入中位数和房屋价值中位数的增长情况
误差范围	人口、家庭收入中位数、人均收入、房屋价值中位数和租金中位数的90%置信误差

主要API端点

端点	功能
GET /zip/{zipCode}	查询单个ZIP Code的人口统计数据
GET /aggregate	给定圆心和半径，返回区域内所有ZIP Code加总数据
GET /area/state、county、metro	查询州、县或都会区的官方发布数据
POST /batch	一次请求批量查询多达数百个ZIP Code
GET /match	按目标画像匹配ZIP Code（如最低收入、最小人口、增长率等条件组合）
GET /trend/{zipCode}	返回所有历史发布版本及每期之间的变化
POST /aggregate/sites	计算多个门店覆盖区域的重叠情况
GET /rank	按单一指标排名ZIP Code
GET /compare	比较两个ZIP Code

特殊处理机制

无数据ZIP Code（PO Box / 专用编码）

全美近四分之一的ZIP Code为PO Box或专用编码，不覆盖实际土地。查询此类编码时：

• 默认返回最近的有数据区域，并标记 "approximate": true 及原因说明
• 设置 approximate=false 可拒绝此回退，返回 found: false

字段为null的含义

数据为5年调查估计，若估计值因不可靠未发布，字段即为null。null不代表零，表示"未发布"。

数据限制说明

• 顶码限制：高收入和高房屋价值区间设有上限（收入中位数250,001美元、房屋价值2,000,001美元即表示"达到或超过该值"）
• 密度计算：仅基于陆地面积，不包括水域
• ZIP Code整算原则：区域内ZIP Code若中心点位于圆圈内则整个计入
• 趋势数据注意：连续两期5年发布版本有4年重复，变化幅度可能被低估

计费套餐与限制

计划	最大半径	每次响应行数	每次调用站点数	每批ZIP Code数	价格
BASIC	25 km / 15.5 mi	25	3	10	免费
PRO	100 km / 62 mi	250	10	100	$19.00/月
ULTRA	500 km / 310 mi	1,000	25	500	$79.00/月
MEGA	20,000 km	5,000	100	1,000	$249.00/月

错误处理方式

状态码	含义
200, found: true	正常返回结果
200, found: false	无此ZIP Code或半径内无数据（并非错误）
400	参数缺失、格式错误或超出当前计划限制
403	无有效订阅且无剩余配额
429	匿名用户每日配额已用尽
503	服务暂时不可用

注意：miss（未命中）返回200及found: false，不属于错误，应检查found字段而非仅看状态码。

提供方信息

• API创建者：Payloadic
• 订阅者数量：1
• 类别：eCommerce