Tomorrow.io Weather Forecast API
CloseTomorrow.io Weather Forecast API
Tomorrow.io 官方 GET forecast 文档按位置返回天气预报,说明未来120小时小时级、5天日级及premium的未来1小时分钟级。需query方式API key;完整JSON字段、费率及配额未在本页,未查询当前天气。
Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.
- Stable ID
- cap-de69f7e7f3e6a4f7e9eb2b91
- Card version
- 2
- Updated
- 2026-10-24T18:53:54.7809661+00:00
- Ownership state
- unclaimed
- Processing
- unknown
- Evidence level
- unknown
- Business execution
- unknown
Keep this fixed version · Original public source · Complete machine record
Published description
该参考页支持坐标、城市、美国邮编或英国postcode定位,以及时间步长和单位选择。页面只给能力/参数与状态码,响应展示框未展开schema;本卡不将其视作真实预报或接口运行结果。
Inputs
- location必填;示例支持42.3478,-71.0466、new york、10001 US、SW1。
- timesteps为字符串数组,本页列hourly=1h、daily=1d;序列化细节未说明。
- units可metric或imperial;具体字段单位需对应Field Descriptors。
Outputs
- 文档描述最多未来120小时小时级和5天日级预报;premium可获未来1小时分钟级预报。
- 200为application/json,但本页响应字段/schema未展开;400为错误状态,具体错误对象未给。
Invocation and authentication
{
"authentication": {
"kind": "api_key",
"notes": "\u9875\u9762Credentials\u6807\u4E3AQuery\u5E76\u63D0\u793A\u767B\u5F55\u4F7F\u7528API keys\uFF1B\u672C\u6B21\u6B63\u6587\u672A\u660E\u786E\u67E5\u8BE2key\u7684\u51C6\u786E\u5B57\u6BB5\u540D/\u83B7\u53D6\u5951\u7EA6\uFF0C\u4E0D\u51ED\u8BB0\u5FC6\u8865\u5199\uFF0C\u672A\u53D6\u5F97\u51ED\u636E\u3002"
},
"command": null,
"entry_url": "https://api.tomorrow.io/v4/weather/forecast",
"kind": "http_api",
"method": "GET",
"request_example": {
"method": "GET",
"notes": "\u4F9D\u636E\u5B98\u65B9\u4F4D\u7F6E/\u5355\u4F4D\u53C2\u6570\u6574\u7406\uFF0C\u53E6\u9700\u67E5\u8BE2\u5F0FAPI key\uFF0C\u5176\u7CBE\u786E\u5B57\u6BB5\u5728\u672C\u9644\u4EF6\u672A\u660E\u786E\uFF1B\u672A\u6267\u884C\u3002",
"query": {
"location": "new york",
"units": "metric"
},
"url": "https://api.tomorrow.io/v4/weather/forecast"
},
"requirements": [
"\u9700\u76F8\u5E94Tomorrow.io API key/\u8BA1\u5212\u6743\u9650\uFF1B\u5206\u949F\u7EA7\u9884\u62A5\u660E\u786E\u4EC5premium\u7528\u6237\u3002",
"location\u5FC5\u586B\uFF0C\u53EF\u4E3A\u5750\u6807\u3001\u57CE\u5E02\u3001\u90AE\u7F16\u7B49\uFF1B\u4E0D\u63D0\u4EA4\u771F\u5B9E\u4E2A\u4EBA\u4F4D\u7F6E\u3002",
"\u53C2\u8003\u9875\u6807accept-encoding header\u5FC5\u9700\uFF0C\u9ED8\u8BA4deflate,gzip,br\uFF1B\u5BA2\u6237\u7AEF\u9700\u80FD\u5904\u7406\u5BF9\u5E94\u538B\u7F29\u3002",
"\u672C\u6B21\u4E0D\u6CE8\u518Ckey\u3001\u8FD0\u884CTry It\u6216\u8BF7\u6C42\u5929\u6C14\u6570\u636E\u3002"
]
}Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.
Third-party pricing and data handling
{
"model": "unknown",
"notes": "\u6B63\u6587\u660E\u786E\u5206\u949F\u7EA7\u9700premium\uFF0C\u9875\u9762\u6709Free API Key\u5165\u53E3\uFF0C\u4F46\u672A\u7ED9\u8BE5endpoint\u5B8C\u6574\u8D39\u7387\u3001\u514D\u8D39\u989D\u5EA6\u6216\u8D26\u53F7\u8BA1\u5212\u8303\u56F4\u3002",
"source_url": "https://docs.tomorrow.io/reference/weather-forecast"
}{
"location": "provider_server",
"notes": "\u4F4D\u7F6E\u3001\u5355\u4F4D\u7B49\u67E5\u8BE2\u53C2\u6570\u53CA\u51ED\u636E\u7531Tomorrow.io\u5904\u7406\uFF1B\u6B64\u9875\u672A\u8BF4\u660E\u4F4D\u7F6E\u65E5\u5FD7\u3001\u4FDD\u7559\u6216\u9690\u79C1\u653F\u7B56\u3002\u672C\u6B21\u672A\u63D0\u4EA4\u67E5\u8BE2\u6216\u8BBF\u95EE\u8BF7\u6C42\u5386\u53F2\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 分钟预报的premium条件不能推广为所有账号可用;实际时效、覆盖与准确性未测试。
- 完整天气字段、单位定义和JSON结构在未捕获的参考,不能凭经验补timelines等字段。
- Query凭据字段名、速率/配额、价格和SLA未在渲染正文明确。
- Free API Key导航只说明可获取key,不能据此断言所有调用或分钟级免费。
Unknowns
- 准确query凭据字段/获取流程、完整input序列化和响应schema未知。
- 计划权限、费率、数值限流/配额、SLA、位置数据保留与实时准确性未验证。
Fixed profiles, conditions and evidence
Read state: not_checked; review state: unknown. Do not combine different profiles.
资料与来源声明不等于本站实测;未列出的条件仍未知。
结构化配方只按公开声明检查约束与接口,不执行任务或授予权限;缺失记录保持未知,接口兼容不证明实际成功。
Contributor-reported verification
{
"checked_at": "2026-10-24T18:53:08.5957039\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://docs.tomorrow.io/reference/weather-forecast"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.
Dynamic observations and corrections
null
null
Add a public correction or observation
Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.
Propose a sourced summary correction
Report a conditional public observation
Complete fixed public record and original source fields
This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.
{
"author_name": "Tomorrow.io",
"availability": "unknown",
"callability": "documentation_only",
"category": "physical",
"data_handling": {
"location": "provider_server",
"notes": "\u4F4D\u7F6E\u3001\u5355\u4F4D\u7B49\u67E5\u8BE2\u53C2\u6570\u53CA\u51ED\u636E\u7531Tomorrow.io\u5904\u7406\uFF1B\u6B64\u9875\u672A\u8BF4\u660E\u4F4D\u7F6E\u65E5\u5FD7\u3001\u4FDD\u7559\u6216\u9690\u79C1\u653F\u7B56\u3002\u672C\u6B21\u672A\u63D0\u4EA4\u67E5\u8BE2\u6216\u8BBF\u95EE\u8BF7\u6C42\u5386\u53F2\u3002"
},
"description": "\u8BE5\u53C2\u8003\u9875\u652F\u6301\u5750\u6807\u3001\u57CE\u5E02\u3001\u7F8E\u56FD\u90AE\u7F16\u6216\u82F1\u56FDpostcode\u5B9A\u4F4D\uFF0C\u4EE5\u53CA\u65F6\u95F4\u6B65\u957F\u548C\u5355\u4F4D\u9009\u62E9\u3002\u9875\u9762\u53EA\u7ED9\u80FD\u529B/\u53C2\u6570\u4E0E\u72B6\u6001\u7801\uFF0C\u54CD\u5E94\u5C55\u793A\u6846\u672A\u5C55\u5F00schema\uFF1B\u672C\u5361\u4E0D\u5C06\u5176\u89C6\u4F5C\u771F\u5B9E\u9884\u62A5\u6216\u63A5\u53E3\u8FD0\u884C\u7ED3\u679C\u3002",
"inputs": [
"location\u5FC5\u586B\uFF1B\u793A\u4F8B\u652F\u630142.3478,-71.0466\u3001new york\u300110001 US\u3001SW1\u3002",
"timesteps\u4E3A\u5B57\u7B26\u4E32\u6570\u7EC4\uFF0C\u672C\u9875\u5217hourly=1h\u3001daily=1d\uFF1B\u5E8F\u5217\u5316\u7EC6\u8282\u672A\u8BF4\u660E\u3002",
"units\u53EFmetric\u6216imperial\uFF1B\u5177\u4F53\u5B57\u6BB5\u5355\u4F4D\u9700\u5BF9\u5E94Field Descriptors\u3002"
],
"invocation": {
"authentication": {
"kind": "api_key",
"notes": "\u9875\u9762Credentials\u6807\u4E3AQuery\u5E76\u63D0\u793A\u767B\u5F55\u4F7F\u7528API keys\uFF1B\u672C\u6B21\u6B63\u6587\u672A\u660E\u786E\u67E5\u8BE2key\u7684\u51C6\u786E\u5B57\u6BB5\u540D/\u83B7\u53D6\u5951\u7EA6\uFF0C\u4E0D\u51ED\u8BB0\u5FC6\u8865\u5199\uFF0C\u672A\u53D6\u5F97\u51ED\u636E\u3002"
},
"command": null,
"entry_url": "https://api.tomorrow.io/v4/weather/forecast",
"kind": "http_api",
"method": "GET",
"request_example": {
"method": "GET",
"notes": "\u4F9D\u636E\u5B98\u65B9\u4F4D\u7F6E/\u5355\u4F4D\u53C2\u6570\u6574\u7406\uFF0C\u53E6\u9700\u67E5\u8BE2\u5F0FAPI key\uFF0C\u5176\u7CBE\u786E\u5B57\u6BB5\u5728\u672C\u9644\u4EF6\u672A\u660E\u786E\uFF1B\u672A\u6267\u884C\u3002",
"query": {
"location": "new york",
"units": "metric"
},
"url": "https://api.tomorrow.io/v4/weather/forecast"
},
"requirements": [
"\u9700\u76F8\u5E94Tomorrow.io API key/\u8BA1\u5212\u6743\u9650\uFF1B\u5206\u949F\u7EA7\u9884\u62A5\u660E\u786E\u4EC5premium\u7528\u6237\u3002",
"location\u5FC5\u586B\uFF0C\u53EF\u4E3A\u5750\u6807\u3001\u57CE\u5E02\u3001\u90AE\u7F16\u7B49\uFF1B\u4E0D\u63D0\u4EA4\u771F\u5B9E\u4E2A\u4EBA\u4F4D\u7F6E\u3002",
"\u53C2\u8003\u9875\u6807accept-encoding header\u5FC5\u9700\uFF0C\u9ED8\u8BA4deflate,gzip,br\uFF1B\u5BA2\u6237\u7AEF\u9700\u80FD\u5904\u7406\u5BF9\u5E94\u538B\u7F29\u3002",
"\u672C\u6B21\u4E0D\u6CE8\u518Ckey\u3001\u8FD0\u884CTry It\u6216\u8BF7\u6C42\u5929\u6C14\u6570\u636E\u3002"
]
},
"limitations": [
"\u5206\u949F\u9884\u62A5\u7684premium\u6761\u4EF6\u4E0D\u80FD\u63A8\u5E7F\u4E3A\u6240\u6709\u8D26\u53F7\u53EF\u7528\uFF1B\u5B9E\u9645\u65F6\u6548\u3001\u8986\u76D6\u4E0E\u51C6\u786E\u6027\u672A\u6D4B\u8BD5\u3002",
"\u5B8C\u6574\u5929\u6C14\u5B57\u6BB5\u3001\u5355\u4F4D\u5B9A\u4E49\u548CJSON\u7ED3\u6784\u5728\u672A\u6355\u83B7\u7684\u53C2\u8003\uFF0C\u4E0D\u80FD\u51ED\u7ECF\u9A8C\u8865timelines\u7B49\u5B57\u6BB5\u3002",
"Query\u51ED\u636E\u5B57\u6BB5\u540D\u3001\u901F\u7387/\u914D\u989D\u3001\u4EF7\u683C\u548CSLA\u672A\u5728\u6E32\u67D3\u6B63\u6587\u660E\u786E\u3002",
"Free API Key\u5BFC\u822A\u53EA\u8BF4\u660E\u53EF\u83B7\u53D6key\uFF0C\u4E0D\u80FD\u636E\u6B64\u65AD\u8A00\u6240\u6709\u8C03\u7528\u6216\u5206\u949F\u7EA7\u514D\u8D39\u3002"
],
"outputs": [
"\u6587\u6863\u63CF\u8FF0\u6700\u591A\u672A\u6765120\u5C0F\u65F6\u5C0F\u65F6\u7EA7\u548C5\u5929\u65E5\u7EA7\u9884\u62A5\uFF1Bpremium\u53EF\u83B7\u672A\u67651\u5C0F\u65F6\u5206\u949F\u7EA7\u9884\u62A5\u3002",
"200\u4E3Aapplication/json\uFF0C\u4F46\u672C\u9875\u54CD\u5E94\u5B57\u6BB5/schema\u672A\u5C55\u5F00\uFF1B400\u4E3A\u9519\u8BEF\u72B6\u6001\uFF0C\u5177\u4F53\u9519\u8BEF\u5BF9\u8C61\u672A\u7ED9\u3002"
],
"pricing": {
"model": "unknown",
"notes": "\u6B63\u6587\u660E\u786E\u5206\u949F\u7EA7\u9700premium\uFF0C\u9875\u9762\u6709Free API Key\u5165\u53E3\uFF0C\u4F46\u672A\u7ED9\u8BE5endpoint\u5B8C\u6574\u8D39\u7387\u3001\u514D\u8D39\u989D\u5EA6\u6216\u8D26\u53F7\u8BA1\u5212\u8303\u56F4\u3002",
"source_url": "https://docs.tomorrow.io/reference/weather-forecast"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [],
"sources": [
{
"basis": "official_documentation",
"checked_at": "2026-10-25T02:53:08.5957039\u002B08:00",
"title": "Weather Forecast",
"url": "https://docs.tomorrow.io/reference/weather-forecast"
}
],
"summary": "Tomorrow.io \u5B98\u65B9 GET forecast \u6587\u6863\u6309\u4F4D\u7F6E\u8FD4\u56DE\u5929\u6C14\u9884\u62A5\uFF0C\u8BF4\u660E\u672A\u6765120\u5C0F\u65F6\u5C0F\u65F6\u7EA7\u30015\u5929\u65E5\u7EA7\u53CApremium\u7684\u672A\u67651\u5C0F\u65F6\u5206\u949F\u7EA7\u3002\u9700query\u65B9\u5F0FAPI key\uFF1B\u5B8C\u6574JSON\u5B57\u6BB5\u3001\u8D39\u7387\u53CA\u914D\u989D\u672A\u5728\u672C\u9875\uFF0C\u672A\u67E5\u8BE2\u5F53\u524D\u5929\u6C14\u3002",
"tags": [
"http_api",
"documentation_only",
"weather_forecast"
],
"terms_url": null,
"title": "Tomorrow.io Weather Forecast API",
"unknowns": [
"\u51C6\u786Equery\u51ED\u636E\u5B57\u6BB5/\u83B7\u53D6\u6D41\u7A0B\u3001\u5B8C\u6574input\u5E8F\u5217\u5316\u548C\u54CD\u5E94schema\u672A\u77E5\u3002",
"\u8BA1\u5212\u6743\u9650\u3001\u8D39\u7387\u3001\u6570\u503C\u9650\u6D41/\u914D\u989D\u3001SLA\u3001\u4F4D\u7F6E\u6570\u636E\u4FDD\u7559\u4E0E\u5B9E\u65F6\u51C6\u786E\u6027\u672A\u9A8C\u8BC1\u3002"
],
"verification": {
"checked_at": "2026-10-24T18:53:08.5957039\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://docs.tomorrow.io/reference/weather-forecast"
],
"level": "documentation_only",
"not_verified": [
"\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
],
"outcome": "not_tested",
"reported_by": "contributor",
"software_version": null,
"test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
},
"schema_version": "navonavo.capability.v1",
"service_id": "cap-de69f7e7f3e6a4f7e9eb2b91",
"version": 2,
"source_url": "https://docs.tomorrow.io/reference/weather-forecast",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"url": "https://docs.tomorrow.io/reference/weather-forecast",
"final_url": "https://docs.tomorrow.io/reference/weather-forecast",
"status_code": 200,
"title": "Weather Forecast",
"description": "Using the weather forecast API you can access up-to-date weather information for your location, including minute-by-minute forecasts (for premium users) for the next hour, hourly forecasts for the next 120 hours, and daily forecasts for the next 5 days. For the location query parameter we support mu\u2026",
"checked_at": "2026-10-24T18:53:08.5957039\u002B00:00",
"warnings": [
"\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
]
},
"created_at": "2026-10-24T18:53:12.4550460\u002B00:00",
"updated_at": "2026-10-24T18:53:54.7809661\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-de69f7e7f3e6a4f7e9eb2b91?version=2",
"page_url": "https://navonavo.com/capabilities/cap-de69f7e7f3e6a4f7e9eb2b91?version=2",
"verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
"library_material": {
"organization": "organized",
"semantic_state": "classified",
"semantic_category": "\u6C14\u8C61\u6570\u636E\uFF0FTomorrow.io \u4F4D\u7F6E\u5929\u6C14\u9884\u62A5\u63A5\u53E3",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-9ef87abbece8afeeea5e192bdcf6b709",
"source_url": "https://docs.tomorrow.io/reference/weather-forecast",
"content_sha256": "487ad076c60d8c5b80dfac2bc37889df153a8c4f0f358e717d6577b963d33a72",
"decoded_bytes": 511677,
"content_type": "text/html",
"captured_at": "2026-10-24T18:53:08.5957039\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "487ad076c60d8c5b80dfac2bc37889df153a8c4f0f358e717d6577b963d33a72",
"text_utf8_bytes": 511677,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-de69f7e7f3e6a4f7e9eb2b91/materials/material-9ef87abbece8afeeea5e192bdcf6b709?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-6c87e1b3edfc4d5a8eb5c94d6ff5510d",
"reason": "\u4F9D\u636E\u672C\u6279Tomorrow.io Weather Forecast\u6B63\u6587\u7684\u660E\u786EHTTPS GET\u3001\u4F4D\u7F6E/\u6B65\u957F/\u5355\u4F4D\u3001\u9884\u6D4B\u65F6\u6BB5\u548Cpremium\u6761\u4EF6\u6574\u7406\uFF0C\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u53EAdocumentation_only\uFF0C\u672A\u8FD0\u884C\u6D4B\u8BD5\u6216\u83B7\u53D6key\uFF0C\u4E0D\u8865\u9020query\u51ED\u636E\u540D/\u54CD\u5E94\u5B57\u6BB5\uFF1B\u8BA1\u8D39\u548C\u914D\u989D\u4FDD\u672A\u77E5\u3002",
"source_urls": [
"https://docs.tomorrow.io/reference/weather-forecast"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-de69f7e7f3e6a4f7e9eb2b91",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-de69f7e7f3e6a4f7e9eb2b91?version=2",
"page_url": "https://navonavo.com/capabilities/cap-de69f7e7f3e6a4f7e9eb2b91?version=2",
"profiles": [],
"warnings": [
"\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
"\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
]
}
}