A free, keyless API for sunrise, sunset, twilight, and day-length times for any latitude/longitude.
This is a community listing. If you own this API, you can request ownership.
npm install omnistream-sdkimport { 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("sunrisesunset/getSunTimes");One install, one key - the same client calls every API on the marketplace.
YYYY-MM-DD or 'today'
Sun times for a location
/**
* SunriseSunset - generated by OmniStream from Sunrise Sunset's OpenAPI spec.
* One typed method per endpoint. A single Omni key reaches the API.
*/
const DEFAULT_BASE = "https://grid.skinvaults.online/v1/proxy/sunrisesunset";
export class SunriseSunsetError extends Error {
status: number;
code?: string;
constructor(status: number, code: string | undefined, message?: string) {
super(message || `SunriseSunset error ${status}`);
this.name = "SunriseSunsetError";
this.status = status;
this.code = code;
}
}
export interface SunriseSunsetOptions {
baseUrl?: string;
fetch?: typeof fetch;
timeoutMs?: number;
}
export class SunriseSunset {
/** @param token Your OmniStream key (one key for every API). */
constructor(private token: string, private opts: SunriseSunsetOptions = {}) {
if (!token) throw new Error("SunriseSunset: 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 SunriseSunsetError(res.status, data?.error?.code, data?.error?.message);
return data.data ?? data;
}
/** Sun times for a location */
getSunTimes(params: { "lat": number; "lng": number; "date"?: string; "formatted"?: number }): Promise<any> {
return this._request("GET", "/json", { params });
}
}
export default SunriseSunset;
No reviews yet. Be the first to rate this API.
No. Sunrise Sunset is included with your Omni key, so a single OmniStream key is enough to start calling it. There is no separate signup with the provider and no second key to manage.
A free, keyless API for sunrise, sunset, twilight, and day-length times for any latitude/longitude. It exposes 1 endpoint over GET, including GET /json.
Install the OmniStream SDK for your language and call Sunrise Sunset 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.
You can start on the free plan. OmniStream charges for the unified SDK, key storage and proxy rather than for Sunrise Sunset itself.
NASA APOD: NASA Astronomy Picture of the Day - the daily image and its metadata, ready to embed in your own apps.