美国调整后 B 类拒签率
FY2006–FY2025 · 20 个财政年度。官方数值统计,已启用商业访问。
规范化 JSON、官方来源溯源、历史统计与明确的新鲜度信息。
提供免费评估访问 · 商业 API 请联系我们 · 非实时数据,非政府 API
FY2006–FY2025 · 20 个财政年度。官方数值统计,已启用商业访问。
目前一期 IRCC 快照。仅限非商业评估,商业再分发许可待确认。
其他体系、美国预约候时、护照通行、护照图片及第三国通行暂缓开放。不声称覆盖全世界。
Base URLhttps://visadatahub.com/api/v1/
从服务器通过 Authorization 请求头发送密钥。不要放入 URL、浏览器脚本、移动端包或截图。全部 v1 端点(包括元数据和健康检查)需要密钥;只有 OpenAPI 文档公开。
Authorization: Bearer YOUR_API_KEY密钥以 vdh_live_ 或 vdh_test_ 开头,人工签发、仅显示一次、可以撤销。默认仅用于服务器之间的请求,不开放浏览器 CORS 访问。
curl -H "Authorization: Bearer YOUR_API_KEY" "https://visadatahub.com/api/v1/visa-statistics/us/refusal-rates?nationality=CN&from=2020&to=2025&include_sources=true"{
"data": [
{
"jurisdiction_id": "united-states",
"visa_type_id": "b",
"nationality_country_id": "cn",
"nationality_label": "CHINA",
"nationality_slug": "china",
"fiscal_year": 2025,
"metric_type": "adjusted_b_visa_refusal_rate",
"value": 20.21,
"unit": "percent",
"source_id": "us-adjusted-b-refusal",
"period": {
"type": "fiscal_year",
"year": 2025
},
"official_updated_at": null,
"visadatahub_checked_at": "2026-10-04T17:53:13Z",
"retrieved_at": "2026-10-04T17:53:13Z"
}
],
"meta": {
"api_version": "v1",
"status": "ready",
"dataset_id": "us-b-refusal",
"freshness": {
"official_updated_at": null,
"visadatahub_checked_at": "2026-10-04T17:53:13Z",
"retrieved_at": "2026-10-04T17:53:13Z",
"period": {
"type": "fiscal_year",
"from": 2006,
"to": 2025
}
},
"pagination": {
"limit": 1,
"total": 1,
"next_cursor": null
},
"sources": [
{
"source_id": "us-adjusted-b-refusal",
"organization": "U.S. Department of State",
"title": "Nonimmigrant B Visa Adjusted Refusal Rates by Nationality",
"url": "https://travel.state.gov/content/travel/en/legal/visa-law0/visa-statistics/nonimmigrant-visa-statistics/nonimmigrant-b-visa-adjusted-refusal-rates-by-nationality.html"
}
],
"request_id": "vdh_req_example"
}
}现有数据集的一条静态示例;页面没有嵌入商业密钥。
仅支持 GET。字段保持稳定的英文 snake_case;lang=en 或 zh-cn 仅改变显示标签。
| 端点 | 用途 |
|---|---|
GET / | API 概览 |
GET /health | 最小健康检查(需要认证) |
GET /meta | 数据发布状态与指标定义 |
GET /countries | 国家与地区 ID |
GET /datasets | 按 ID 查询国家或地区 |
GET /countries/{country_id} | 已开放的签证体系 |
GET /visa-systems | 签证类别 ID |
GET /visa-types | 官方来源 |
GET /sources | 加拿大处理时间(评估版) |
GET /processing-times | 加拿大本地处理时间快照 |
GET /processing-times/canada | 加拿大历史快照(目前仅一期) |
GET /history/processing-times/canada | 美国调整后 B 类拒签率 |
GET /visa-statistics/united-states | 美国拒签率端点别名 |
GET /visa-statistics/us/refusal-rates |
limit=1…100 · cursor · include_sources=true · lang=en|zh-cn
读取 meta.pagination.next_cursor,直到 null。游标绑定结果集,数据或筛选变化后失效。指标支持 sort=value_asc 或 value_desc,null 排在最后。元数据仅支持 sort=default。
加拿大:application_type=visitor-outside-canada|supervisa|study|work,applying_from=CN 或国家 ID,from/to=YYYY-MM-DD。美国:nationality=CN,from/to=财政年度(2006–2025)。未知或重复参数返回 400。
默认评估:总计 500 次、每个 UTC 自然月最多 500 次、每分钟 10 次,14 天后过期。其他额度人工协商。通过认证并获准的请求(包括 304 和参数错误)计入配额。
读取 X-RateLimit-Remaining 和 X-Quota-Remaining。429 含以秒计的 Retry-After,请退避重试。ETag / If-None-Match 支持认证后的 304;只能私有缓存并重新验证。
| 400 | invalid_parameter |
|---|---|
| 401 | missing_api_key / invalid_api_key |
| 403 | revoked_api_key / expired_api_key / data_unavailable |
| 404 | not_found |
| 405 | method_not_allowed |
| 429 | rate_limit_exceeded / quota_exceeded |
| 500 | internal_error |
| 503 | data_unavailable |
{
"error": {
"code": "invalid_parameter",
"message": "limit must be 1–100."
},
"request_id": "vdh_req_example"
}official_updated_at:官方更新日期;visadatahub_checked_at:本站成功核对时间;retrieved_at:快照采集时间。三者不混用。未知日期和缺失值返回 null,不变成 0。period 表示统计期。include_sources=true 返回来源机构和链接。
调整后拒签率不是个人获批概率,历史负调整值予以保留。加拿大处理时间不是面谈候时,单期快照不能构成趋势。API 读取已验证本地文件,不在客户调用时抓取政府网站。
数据与来源 →独立信息服务,与美国等各国政府无关。不保证可用性或签证结果。数据和访问范围可能变化,官方机构为最终来源。遵守配额,禁止滥用、分享密钥和绕过访问控制。再分发或转售须获得访问协议明确许可,并保留来源标注。来源链接不授予第三方内容权利。加拿大 BETA 在商业许可确认前仅限非商业评估。
用量按密钥 ID、端点类别、小时、状态码和延迟汇总。日志不存储原始密钥或请求参数。防滥用标识使用每日加盐哈希,分钟计数几分钟后清理;用量汇总保留 90 天。 隐私
可申请免费评估访问。商业 API 请联系我们。通过现有联系入口提交“API 访问申请”,并提供: