Weather — entry 027 of 31
Visual Crossing
Visual Crossing exposes over 50 years of historical weather observations alongside current conditions and 15-day forecasts through a single flexible endpoint. Requests can span multiple locations and date ranges at once, returning around 100 weather elements including agriculture, energy, and air-quality metrics.
AuthenticationAPI KeySign up with the provider to obtain credentials.
HTTPSSupportedTraffic is encrypted in transit.
CORSEnabledCallable directly from browser JavaScript.
PricingFreemiumA usable free tier exists, with paid plans for more volume.
FormatsJSON, CSVResponses can be requested as JSON or CSV.
GreatAPIs Score
Score87
Authentication15/25API key required
Pricing17/20Freemium tier available
Docs20/20Machine-readable spec file bundled
Formats15/15Supports 2 response formats
Freshness20/20Verified within 6 months
Embed this badge
<a href="https://greatapis.com/api/visual-crossing/"><img src="https://greatapis.com/badge/visual-crossing.svg" alt="Scored 87 on greatapis.com"></a>Auth quickstart
- Get a key at the provider
- Send it on every request as a header
Authorization: <key> - The exact header isn't documented — Authorization is a common default; confirm in the provider's docs.
Stored keyNo key stored
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
Historical Weather1
GET/VisualCrossingWebServices/rest/services/weatherdata/historyRetrieves hourly or daily historical weather records.
Parameters
| Name | In | Required | Type |
|---|---|---|---|
maxDistance | query | no | string |
shortColumnNames | query | no | boolean |
endDateTime | query | no | string |
aggregateHours | query | no | string |
collectStationContributions | query | no | boolean |
startDateTime | query | no | string |
maxStations | query | no | string |
allowAsynch | query | no | boolean |
locations | query | no | string |
includeNormals | query | no | boolean |
contentType | query | no | string |
unitGroup | query | no | string |
key | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Auto generated using Swagger Inspector | — |
Timeline Weather API (15-day forecast request)1
GET/VisualCrossingWebServices/rest/services/timeline/{location}Historical and Forecast Weather API
Parameters
| Name | In | Required | Type |
|---|---|---|---|
location | path | yes | string |
contentType | query | no | string |
unitGroup | query | no | string |
include | query | no | string |
lang | query | no | string |
key | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Auto generated using Swagger Inspector | — |
Timeline Weather API (date range request)1
GET/VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}/{enddate}Historical and Forecast Weather API
Parameters
| Name | In | Required | Type |
|---|---|---|---|
location | path | yes | string |
startdate | path | yes | string |
enddate | path | yes | string |
contentType | query | no | string |
unitGroup | query | no | string |
include | query | no | string |
lang | query | no | string |
key | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Auto generated using Swagger Inspector | — |
Timeline Weather API (single date request)1
GET/VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}Historical and Forecast Weather API
Parameters
| Name | In | Required | Type |
|---|---|---|---|
location | path | yes | string |
startdate | path | yes | string |
contentType | query | no | string |
unitGroup | query | no | string |
include | query | no | string |
lang | query | no | string |
key | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Auto generated using Swagger Inspector | — |
Weather Forecast1
GET/VisualCrossingWebServices/rest/services/weatherdata/forecastWeather Forecast API
Parameters
| Name | In | Required | Type |
|---|---|---|---|
sendAsDatasource | query | no | boolean |
allowAsynch | query | no | boolean |
shortColumnNames | query | no | boolean |
locations | query | no | string |
aggregateHours | query | no | string |
contentType | query | no | string |
unitGroup | query | no | string |
key | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | Auto generated using Swagger Inspector | — |
Try it
Developer reference
Base URL
https://weather.visualcrossing.comRate limit
Paid plans billed per weather record (Professional: 10M records/month); Metered/Corporate unlimited under a fair-use policy
Key endpoints
- GET/VisualCrossingWebServices/rest/services/timeline/{location}
- GET/VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}/{enddate}