Wyzie Subs

API Keys#

Wyzie Subs requires an API key for all requests. A free tier covers most use cases; paid plans handle heavier usage.

Tiers#

Tier	What it costs	Limit
Free	Free (Gmail required)	1,000 requests / UTC day
Pro	$5 one-time	400,000 requests
Top-ups	from $0.0625 / 5K	Adds to your paid balance

Pro and top-ups don't expire. Prefer recurring? A $32/month subscription gives 6,000,000 requests/month (card only). See store.wyzie.io for full pricing and the dashboard.

Getting a Free Key#

Visit store.wyzie.io/redeem:

Solve a quick Cloudflare Turnstile captcha.
Enter a Gmail address (only Gmail is accepted for the free tier).
Enter the 6-digit code we email you.
You receive an API key that looks like wyzie-abc123...

Each Gmail address can only redeem one free key. Already had a free key tied to that email? Verifying again just returns your existing key.

Upgrading to Pro#

Visit store.wyzie.io and check out with the same email you used for your free key. Your existing wyzie-... key is upgraded in place with 400K paid requests added on top. Prefer recurring? A $32/month subscription adds a 6,000,000-request monthly allowance (card only) instead.

If you check out with a brand new email (no prior key), a fresh wyzie-... key is generated and emailed to you.

Keep Your Key Off the Client#

Never embed your API key in client-side code. Browser JavaScript, mobile apps, browser extensions, Electron-style desktop apps, and public Git repositories are all considered client-side. Anything you ship to an end user can be inspected by them, and we have seen real cases where users pasted their key into a streaming site's frontend, only to have a third party scrape the JS bundle and drain the request balance within hours. Quota consumed this way is not refundable.

Two safe ways to use the key from a client app:

Use Wyzie Worker: a free Cloudflare Worker proxy that holds your key server-side. Point your client at the Worker URL instead of sub.wyzie.io.
Run your own proxy: any backend endpoint that appends the key before forwarding to sub.wyzie.io works. See the Intro page for a 10-line example.

If the key shows up in a network tab in DevTools, it is exposed. Assume it is public and rotate it by emailing support.

Using Your Key#

Append &key=YOUR_KEY to every API request:

https://sub.wyzie.io/search?id=tt3659388&key=YOUR_KEY
https://sub.wyzie.io/search?id=286217&language=en&key=YOUR_KEY
https://sub.wyzie.io/search?id=tt0121955&season=1&episode=1&key=YOUR_KEY

NPM Package#

Pass key alongside your other search parameters:

import { searchSubtitles } from "wyzie-lib";
 
const data = await searchSubtitles({
  tmdb_id: 286217,
  language: ["en"],
  key: "YOUR_KEY",
});

Or set it once globally with configure so every request includes it automatically:

import { configure, searchSubtitles } from "wyzie-lib";
 
configure({
  baseUrl: "https://sub.wyzie.io",
  key: "YOUR_KEY",
});
 
const data = await searchSubtitles({
  tmdb_id: 286217,
  language: ["en"],
});

Hitting the Limit#

Free tier depleted -> API returns 429 with X-RateLimit-Reset and Retry-After headers. Daily counter resets at UTC midnight.
Paid balance exhausted -> API returns 402. Top up at store.wyzie.io/topup or enable auto top-up in your dashboard to refill automatically when your balance crosses a threshold you set.

FAQ#

I lost my key. Can I get a new one?

Visit store.wyzie.io and use the "forgot key" flow with your registered email; we'll re-send your existing key.

Can I use one key in multiple projects?

Yes. Your key works anywhere you call the API.

Will my key ever expire?

No. Free and paid keys both have no expiry. Free keys are capped per day; paid balance persists until you use it.

Is auto top-up safe?

You set a monthly spend cap. We never charge above that, and one-click disable is in every confirmation email plus your dashboard.

AI Translation

Overview

Donations