Search and fetch high-quality free photos. Bring your own Unsplash access key (enter it as 'Client-ID YOURACCESSKEY').
Bring your own key. This API needs your own Unsplash 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.
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("unsplash/searchPhotos");One install, one key - the same client calls every API on the marketplace.
Search photos
A random photo
/**
* Unsplash - generated by OmniStream from Unsplash's OpenAPI spec.
* One typed method per endpoint. A single Omni key reaches the API.
*/
const DEFAULT_BASE = "https://grid.skinvaults.online/v1/proxy/unsplash";
export class UnsplashError extends Error {
status: number;
code?: string;
constructor(status: number, code: string | undefined, message?: string) {
super(message || `Unsplash error ${status}`);
this.name = "UnsplashError";
this.status = status;
this.code = code;
}
}
export interface UnsplashOptions {
baseUrl?: string;
fetch?: typeof fetch;
timeoutMs?: number;
}
export class Unsplash {
/** @param token Your OmniStream key (one key for every API). */
constructor(private token: string, private opts: UnsplashOptions = {}) {
if (!token) throw new Error("Unsplash: 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 UnsplashError(res.status, data?.error?.code, data?.error?.message);
return data.data ?? data;
}
/** Search photos */
searchPhotos(params: { "query": string; "per_page"?: number }): Promise<any> {
return this._request("GET", "/search/photos", { params });
}
/** A random photo */
randomPhoto(): Promise<any> {
return this._request("GET", "/photos/random", {});
}
}
export default Unsplash;
No reviews yet. Be the first to rate this API.
Yes. Unsplash 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.
Search and fetch high-quality free photos. Bring your own Unsplash access key (enter it as 'Client-ID YOURACCESSKEY'). It exposes 2 endpoints over GET, including GET /search/photos, GET /photos/random.
Install the OmniStream SDK for your language and call Unsplash 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 Unsplash itself, and Unsplash's own rate limits still apply to your provider key.
Giphy: Search, translate, trending, and random GIFs and stickers from the GIPHY library.