API Keys#

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

Tiers#

Pro and top-ups don't expire and there's no subscription. See store.wyzie.io for full pricing and the dashboard.

Getting a Free Key#

Visit store.wyzie.io/redeem:

1. Solve a quick Cloudflare Turnstile captcha.
2. Enter a Gmail address (only Gmail is accepted for the free tier).
3. Enter the 6-digit code we email you.
4. 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 100K (currently 150K promo) paid requests added on top.

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

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.