APIHub
Back to Explore

Visual Crossing

The Visual Crossing API provides access to historical weather observations and forecast data for a given location, supporting date‑range queries, hourly or daily aggregation, selectable output formats (JSON or CSV), and optional inclusion of alerts, current conditions, and language‑specific descriptions.

Weather
apiKey
HTTPS
CORS: Yes
Description enriched
Visit official documentation

Latency

11329ms p95

Uptime

50.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/VisualCrossingWebServices/rest/services/timeline/{location}

Historical and Forecast Weather API

  • location (path, required) — Locaton of interest as an address, partial address or decimal latitude,longtude value
  • contentType (query) — data format of the output either json or CSV
  • unitGroup (query)
  • include (query) — data to include in the output (required for CSV format - days,hours,alerts,current,events )
  • lang (query) — Language to use for weather descriptions
  • key (query, required)
GET

/VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}

Historical and Forecast Weather API

  • location (path, required)
  • startdate (path, required)
  • contentType (query) — data format of the output either json or CSV
  • unitGroup (query)
  • include (query) — data to include in the output (required for CSV format - days,hours,alerts,current,events )
  • lang (query) — Language to use for weather descriptions
  • key (query, required)
GET

/VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}/{enddate}

Historical and Forecast Weather API

  • location (path, required)
  • startdate (path, required)
  • enddate (path, required)
  • contentType (query) — data format of the output either json or CSV
  • unitGroup (query)
  • include (query) — data to include in the output (required for CSV format - days,hours,alerts,current,events )
  • lang (query) — Language to use for weather descriptions
  • key (query, required)
GET

/VisualCrossingWebServices/rest/services/weatherdata/forecast

Weather Forecast API

  • sendAsDatasource (query)
  • allowAsynch (query)
  • shortColumnNames (query)
  • locations (query)
  • aggregateHours (query)
  • contentType (query)
  • unitGroup (query)
  • key (query)
GET

/VisualCrossingWebServices/rest/services/weatherdata/history

Retrieves hourly or daily historical weather records.

  • maxDistance (query)
  • shortColumnNames (query)
  • endDateTime (query)
  • aggregateHours (query)
  • collectStationContributions (query)
  • startDateTime (query)
  • maxStations (query)
  • allowAsynch (query)
  • locations (query)
  • includeNormals (query)
  • contentType (query)
  • unitGroup (query)
  • key (query)

5 endpoints auto-detected

Authentication

This API requires authentication: apiKey.

curl -X GET \
  "https://www.visualcrossing.com/weather-api/VisualCrossingWebServices/rest/services/timeline/{location}"

www.visualcrossing.com · HTTPS only