独立信息网站,与美国等各国政府无隶属关系。各模块数据来源不同,出行前请核对原始来源。
DEVELOPER PLATFORM · v1

面向开发者的签证与出行数据

规范化 JSON、官方来源溯源、历史统计与明确的新鲜度信息。

提供免费评估访问 · 商业 API 请联系我们 · 非实时数据,非政府 API

从明确的数据范围开始

READY

美国调整后 B 类拒签率

FY2006–FY2025 · 20 个财政年度。官方数值统计,已启用商业访问。

BETA · 仅评估

加拿大处理时间快照

目前一期 IRCC 快照。仅限非商业评估,商业再分发许可待确认。

其他体系、美国预约候时、护照通行、护照图片及第三国通行暂缓开放。不声称覆盖全世界。

Base URL
https://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"
响应示例 · 中国,FY2025
{
  "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;只能私有缓存并重新验证。

400invalid_parameter
401missing_api_key / invalid_api_key
403revoked_api_key / expired_api_key / data_unavailable
404not_found
405method_not_allowed
429rate_limit_exceeded / quota_exceeded
500internal_error
503data_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 读取已验证本地文件,不在客户调用时抓取政府网站。

数据与来源 →

API 使用条款

独立信息服务,与美国等各国政府无关。不保证可用性或签证结果。数据和访问范围可能变化,官方机构为最终来源。遵守配额,禁止滥用、分享密钥和绕过访问控制。再分发或转售须获得访问协议明确许可,并保留来源标注。来源链接不授予第三方内容权利。加拿大 BETA 在商业许可确认前仅限非商业评估。

用量按密钥 ID、端点类别、小时、状态码和延迟汇总。日志不存储原始密钥或请求参数。防滥用标识使用每日加盐哈希,分钟计数几分钟后清理;用量汇总保留 90 天。 隐私

申请访问

可申请免费评估访问。商业 API 请联系我们。通过现有联系入口提交“API 访问申请”,并提供:

  • 姓名、公司和业务邮箱
  • 使用场景和所需数据集
  • 预计每月请求量
  • 商业、学术或个人用途
联系申请 API 访问 →

安装 VisaDataHub