Fuel / Gas Price API

A lightning-fast, production-ready API that serves real-time gas prices for all 50 US states, including national averages, state-level data, and county breakdowns. Built with Redis caching and optimized for lightning fast response times with large throughput.

原始信息汇总

Fuel / Gas Price API 数据集概述

基本信息

• 数据集名称: Fuel / Gas Price API
• 提供者: guffelman
• 类别: Transportation
• API版本: v1 (current)
• 基础URL: fuel-gas-price-api.p.rapidapi.com
• 认证方式: 在请求头 X-RapidAPI-Key 中包含您的 RapidAPI 密钥

服务指标

• 流行度: 9.5
• 服务等级: 100%
• 延迟: 98ms
• 测试通过率: 100%

订阅计划与价格

• BASIC: $0.00 / 月
• PRO: $5.00 / 月
• ULTRA: $20.00 / 月

核心描述

一个高性能的 REST API，提供美国境内准确、实时和历史的汽油价格数据。专为需要快速、可靠地访问美国国家、州和县级燃油价格的开发人员、分析师和应用程序而构建。

主要特性

• 全面覆盖: 国家、州和县级汽油价格数据。
• 历史洞察: 查看多个时间段（日、周、月、年、历史最高）的价格趋势。
• 实时更新: 随着汽油价格变化自动刷新。
• 零停机架构: 完全隔离的数据抓取和交付服务确保持续正常运行。
• 开发者就绪: JSON 输出、现代 REST 规范以及基于 RapidAPI 密钥的身份验证。

数据覆盖范围

• 地理覆盖: 美国所有 50 个州及华盛顿特区。
• 历史范围: 当前、昨天、上周、上月、去年、历史最高。

端点详情

1. 国家平均价格

• 端点: GET /national
• 描述: 获取美国国家平均汽油价格及完整历史数据。
• 响应内容: 包含当前、昨天、一周前、一月前、一年前以及历史最高记录的各类燃油（普通、中级、高级、柴油）价格。

2. 所有州价格

• 端点: GET /states
• 描述: 获取美国所有 50 个州及华盛顿特区的当前汽油价格。
• 响应内容: 包含各州名称、代码及各类燃油价格的数组。

3. 单个州数据

• 端点: GET /state/{stateCode}
• 描述: 获取特定州的详细汽油价格数据，包括历史趋势。
• 路径参数: stateCode（必需），两个字母的州代码（例如 CA, TX, NY, FL）。
• 响应内容: 包含州信息、当前及历史各时间段的各类燃油价格，以及历史最高记录。

4. 州内各县数据

• 端点: GET /state/{stateCode}/counties
• 描述: 获取特定州的县级汽油价格数据。
• 路径参数: stateCode（必需），两个字母的州代码。
• 响应内容: 包含州信息及各县名称和各类燃油价格的数组。
• 注意: 县级数据的可用性因州而异，某些州可能数据有限或没有数据。

5. 健康检查

• 端点: GET /health
• 描述: 检查 API 运行状态和数据新鲜度。
• 响应内容: 包含状态、时间戳、Redis 连接状态和上次数据抓取时间。

6. 抓取器状态

• 端点: GET /status
• 描述: 获取有关上次数据更新的详细元数据。
• 响应内容: 包含当前状态、上次抓取的详细信息（开始时间、完成时间、持续时间、结果统计等）。

错误处理

• 错误响应格式: { "success": false, "error": "Error message here" }
• HTTP 状态码:
  • 200 OK: 请求成功。
  • 400 Bad Request: 无效的州代码或参数。
  • 401 Unauthorized: 缺少或无效的 API 密钥。
  • 404 Not Found: 端点未找到。
  • 429 Too Many Requests: 超出速率限制。
  • 503 Service Unavailable: 数据尚不可用（首次更新前）。

速率限制

速率限制取决于您的 RapidAPI 订阅计划：

• Basic: 100 次请求/天
• Pro: 1,000 次请求/天
• Ultra: 10,000 次请求/天
• Mega: 100,000 次请求/天

响应头包含 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset。

理想用例

• 燃油价格比较和地图应用程序。
• 车队和物流管理平台。
• 经济、市场和能源分析工具。
• 路线规划和成本估算系统。
• 能源趋势的仪表板和可视化工具。

技术支持与可用性

• 支持: 通过 RapidAPI 仪表板联系支持。
• 可用性: 99.9% 正常运行时间 SLA，基于 Redis 保障可靠性，自动数据更新。

搜集汇总

背景与挑战

背景概述

该API提供全美50个州的实时汽油价格数据，包含全国均价、州级和县级细分数据，采用Redis缓存技术确保高吞吐量和快速响应。