Weather Community listing

Visual Crossing Weather

Weather Forecast and Historical Weather Data via RESTful API.

https://weather.visualcrossing.com5 endpointsapiKey authno ratings yet100.0% uptime

Bring your own key. This API needs your own Visual Crossing Weather key - get one from the provider, add it once below, and the proxy injects it on every call. Your OmniStream plan covers the unified SDK, key storage, and proxy - the provider's own rate limits still apply to your key.

This is a community listing. If you own this API, you can request ownership.

Install the SDK

npm install omnistream-sdk

import { OmniClient } from "omnistream-sdk";

const omni = new OmniClient({ token: process.env.OMNI_KEY! });

// One key reaches every API on the marketplace.
const data = await omni.call("visualcrossing/getvisualcrossingwebservices_rest_services_timeline");

One install, one key - the same client calls every API on the marketplace.

Try it

Try itone Omni key, every API

Your Omni key

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

location*

Locaton of interest as an address, partial address or decimal latitude,longtude value

contentType

data format of the output either json or CSV

unitGroup

include

data to include in the output (required for CSV format - days,hours,alerts,current,events )

lang

Language to use for weather descriptions

key*

5 endpoints

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

Historical and Forecast Weather API

location*contentTypeunitGroupincludelangkey*

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

Historical and Forecast Weather API

location*startdate*contentTypeunitGroupincludelangkey*

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

Historical and Forecast Weather API

location*startdate*enddate*contentTypeunitGroupincludelangkey*

GET

Typed client (copy, no install)

visualcrossing.ts

/**
 * VisualCrossingWeather - generated by OmniStream from Visual Crossing Weather's OpenAPI spec.
 * One typed method per endpoint. A single Omni key reaches the API.
 */
const DEFAULT_BASE = "https://grid.skinvaults.online/v1/proxy/visualcrossing";

export class VisualCrossingWeatherError extends Error {
  status: number;
  code?: string;
  constructor(status: number, code: string | undefined, message?: string) {
    super(message || `VisualCrossingWeather error ${status}`);
    this.name = "VisualCrossingWeatherError";
    this.status = status;
    this.code = code;
  }
}

export interface VisualCrossingWeatherOptions {
  baseUrl?: string;
  fetch?: typeof fetch;
  timeoutMs?: number;
}

export class VisualCrossingWeather {
  /** @param token Your OmniStream key (one key for every API). */
  constructor(private token: string, private opts: VisualCrossingWeatherOptions = {}) {
    if (!token) throw new Error("VisualCrossingWeather: token is required");
  }
  rateLimit: { remainingMinute?: number; remainingDay?: number } | null = null;

  private async _request(method: string, path: string, { params, body }: { params?: Record<string, unknown>; body?: unknown } = {}): Promise<any> {
    const f = this.opts.fetch ?? globalThis.fetch;
    const url = new URL((this.opts.baseUrl ?? DEFAULT_BASE).replace(/\/+$/, "") + path);
    if (params) for (const [k, v] of Object.entries(params)) if (v != null) url.searchParams.set(k, String(v));
    const headers: Record<string, string> = { "x-omni-key": this.token };
    if (body !== undefined) headers["content-type"] = "application/json";
    const res = await f(url, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined });
    this.rateLimit = {
      remainingMinute: Number(res.headers.get("x-ratelimit-remaining-minute")) || undefined,
      remainingDay: Number(res.headers.get("x-ratelimit-remaining-day")) || undefined,
    };
    const data = await res.json().catch(() => ({}));
    if (!res.ok) throw new VisualCrossingWeatherError(res.status, data?.error?.code, data?.error?.message);
    return data.data ?? data;
  }

  /** Historical and Forecast Weather API */
  getvisualcrossingwebservicesRestServicesTimeline(params: { "location": string; "key": string; "contentType"?: string; "unitGroup"?: string; "include"?: string; "lang"?: string }): Promise<any> {
    return this._request("GET", "/VisualCrossingWebServices/rest/services/timeline/{location}", { params });
  }

  /** Historical and Forecast Weather API */
  getvisualcrossingwebservicesRestServicesTimeline(params: { "location": string; "startdate": string; "key": string; "contentType"?: string; "unitGroup"?: string; "include"?: string; "lang"?: string }): Promise<any> {
    return this._request("GET", "/VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}", { params });
  }

  /** Historical and Forecast Weather API */
  getvisualcrossingwebservicesRestServicesTimeline(params: { "location": string; "startdate": string; "enddate": string; "key": string; "contentType"?: string; "unitGroup"?: string; "include"?: string; "lang"?: string }): Promise<any> {
    return this._request("GET", "/VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}/{enddate}", { params });
  }

  /** Weather Forecast API */
  getvisualcrossingwebservicesRestServicesWeatherd(params: { "sendAsDatasource"?: boolean; "allowAsynch"?: boolean; "shortColumnNames"?: boolean; "locations"?: string; "aggregateHours"?: string; "contentType"?: string; "unitGroup"?: string; "key"?: string }): Promise<any> {
    return this._request("GET", "/VisualCrossingWebServices/rest/services/weatherdata/forecast", { params });
  }

  /** Retrieves hourly or daily historical weather records. */
  getvisualcrossingwebservicesRestServicesWeatherd(params: { "maxDistance"?: string; "shortColumnNames"?: boolean; "endDateTime"?: string; "aggregateHours"?: string; "collectStationContributions"?: boolean; "startDateTime"?: string; "maxStations"?: string; "allowAsynch"?: boolean; "locations"?: string; "includeNormals"?: boolean; "contentType"?: string; "unitGroup"?: string; "key"?: string }): Promise<any> {
    return this._request("GET", "/VisualCrossingWebServices/rest/services/weatherdata/history", { params });
  }
}

export default VisualCrossingWeather;

Reviews

No reviews yet. Be the first to rate this API.

Frequently asked questions

Do I need an API key to use Visual Crossing Weather?

Yes. Visual Crossing Weather uses apiKey authentication, so you bring your own key from the provider. You store it once on OmniStream and the proxy injects it into every call, so your code only ever sends your Omni key.

What can you do with the Visual Crossing Weather API?

Weather Forecast and Historical Weather Data via RESTful API. It exposes 5 endpoints over GET, including GET /VisualCrossingWebServices/rest/services/timeline/{location}, GET /VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}, GET /VisualCrossingWebServices/rest/services/timeline/{location}/{startdate}/{enddate}.

How do I call Visual Crossing Weather from Python, TypeScript, Rust or Go?

Install the OmniStream SDK for your language and call Visual Crossing Weather through it. The client is generated from this API's OpenAPI spec, so parameters and responses are fully typed, and the same client also calls every other API in the marketplace.

Is Visual Crossing Weather free to use on OmniStream?

You can start on the free plan. OmniStream charges for the unified SDK, key storage and proxy rather than for Visual Crossing Weather itself, and Visual Crossing Weather's own rate limits still apply to your provider key.