DocsGetting started

Add your YouTube API key (optional)

With your own free YouTube Data API key, Nishio can run official searches and fetch channel uploads. Without one, everything else still works locally.

Applies to: Desktop 0.1 · Extension 0.1

Why add a key

The key lets the app talk to Google’s official YouTube Data API on your behalf. It powers “Search with YouTube API” in Start a channel, “Search authorized provider” in the research screens, “Fetch latest videos” for channels and watchlists, and the daily search in Research inbox. Each person uses their own key; the app never ships with a shared one.

Without a key, the built-in niche catalog, imports, the Chrome extension’s page tools, notes, swipefile, ten-video plans, idea drafts and scripts all keep working. Online search simply shows: “Official online search needs your own YouTube API key. Add it in Settings → YouTube.”

Get a free key in Google Cloud

  1. Sign in to the Google Cloud console (console.cloud.google.com) with your Google account.
  2. Create a new project, for example “Nishio”.
  3. Open APIs & Services → Library, search for “YouTube Data API v3” and click Enable.
  4. Open APIs & Services → Credentials, click Create credentials → API key, and copy the key that appears.
  5. Click Edit API key. Under API restrictions choose “Restrict key” and select only YouTube Data API v3. Save.

Paste it into Nishio

  1. Open Settings & team (⌘/Ctrl+,) and scroll to YouTube API accounts.
  2. Under “Your YouTube API key”, paste the key into API key and click “Save key”.
  3. The panel then shows “Key saved” with only the last characters of the key. Use “Replace key” or “Remove key” to change it later.

The key is encrypted on this computer, protected by your system keychain, and is only sent to Google’s official API. It is never stored in the database, never included in backups and never shown again in full. Only the workspace owner can add or change it.

Quotas

Google gives every Cloud project a daily quota. The panel shows “Search calls today”, “Read units today” and the next reset, which happens at midnight Pacific time. These are local estimates; Google Cloud Console is authoritative, and other apps using the same project share the same quota. When the limit is reached, requests stop until the reset and your saved research stays available. Nishio never switches keys automatically to get around a limit. If you need more, request a quota increase from Google.

Searches cost more than readsSearching is the expensive part of the quota. Fetching a channel’s latest 50 public uploads costs 3 read units and no search, so the app reuses cached search results for an identical query instead of asking again.
Keep the key to yourselfDo not paste the key into the Chrome extension, a chat or a shared document. The extension never needs it: when paired, it asks the desktop app, and the app talks to Google.