The Movie Database - movies, TV, people, and images. Bring your own free TMDB API key.
Bring your own key. This API needs your own TMDB 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("tmdb/searchMovie");One install, one key - the same client calls every API on the marketplace.
Search movies by title
Movie details
Trending movies
/**
* TMDB - generated by OmniStream from TMDB's OpenAPI spec.
* One typed method per endpoint. A single Omni key reaches the API.
*/
const DEFAULT_BASE = "https://grid.skinvaults.online/v1/proxy/tmdb";
export class TMDBError extends Error {
status: number;
code?: string;
constructor(status: number, code: string | undefined, message?: string) {
super(message || `TMDB error ${status}`);
this.name = "TMDBError";
this.status = status;
this.code = code;
}
}
export interface TMDBOptions {
baseUrl?: string;
fetch?: typeof fetch;
timeoutMs?: number;
}
export class TMDB {
/** @param token Your OmniStream key (one key for every API). */
constructor(private token: string, private opts: TMDBOptions = {}) {
if (!token) throw new Error("TMDB: 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 TMDBError(res.status, data?.error?.code, data?.error?.message);
return data.data ?? data;
}
/** Search movies by title */
searchMovie(params: { "query": string }): Promise<any> {
return this._request("GET", "/search/movie", { params });
}
/** Movie details */
getMovie(params: { "movieId": number }): Promise<any> {
return this._request("GET", "/movie/{movieId}", { params });
}
/** Trending movies */
trendingMovies(params: { "window": string }): Promise<any> {
return this._request("GET", "/trending/movie/{window}", { params });
}
}
export default TMDB;
No reviews yet. Be the first to rate this API.
Yes. TMDB 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.
The Movie Database - movies, TV, people, and images. Bring your own free TMDB API key. It exposes 3 endpoints over GET, including GET /search/movie, GET /movie/{movieId}, GET /trending/movie/{window}.
Install the OmniStream SDK for your language and call TMDB 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 TMDB itself, and TMDB's own rate limits still apply to your provider key.
TVmaze: A free, keyless TV database - search shows, episodes, cast, and schedules. No sign-up required.