Creator Tools Translator API: Developer Guide

This guide explains how to translate YouTube videos and channels with the Creator Tools translator from your own code. New to the API? Start with the overview: The Creator Tools Translator Is Now Available by API.

Overview

• Translation runs as a background job. You start a job, get a jobId back, and then check the job until it is done.
• Starting a job and checking it use the same address: POST https://api.creator-tools.com/info/longterm-job. The requestType field in the body says which one you want.
• When the job finishes, the translated title, description and subtitles are already published on YouTube.
• There are no callbacks. Check the job status every 5 seconds, the same way the Creator Tools app does.

1. POST /info/longterm-job  { "requestType": "startTranslationJob", … }  →  { "jobId": "…", "status": "IN_PROGRESS" }
2. POST /info/longterm-job  { "requestType": "getJobById", "jobId": "…" }  →  { "status": "IN_PROGRESS" }
   … wait 5 seconds, repeat …
3. POST /info/longterm-job  { "requestType": "getJobById", "jobId": "…" }  →  { "status": "FINISHED", "response": { … } }

Keys You Need

Every request needs four values. You get the gateway key from the support team once. The other three you copy from your browser while you are logged in to https://app.creator-tools.com; the next chapter shows where they are.

All requests are POST with Content-Type: application/json. No cookies or Authorization header are needed.

Finding Your Session ID and Channel ID

Step 1: Log In and Pick the Channel

Open https://app.creator-tools.com, log in, and select the channel you want to translate in the channel list. If the channel is not there yet, add it first with Add channel.

Step 2: Open Local Storage

Open the developer tools (F12 on Windows, ⌥⌘I on Mac) → Application → Local storage → https://app.creator-tools.com → key channels.

The value has one entry for each connected channel. The name of the entry is the channel ID, and the entry holds the session ID:

{
  "UCzOmbH8UyFIVjSAukXAhY5g": {            // ← channelId
    "sessionId": "f35876a8-1…",            // ← sessionId
    "channelId": "UCzOmbH8UyFIVjSAukXAhY5g",
    "name": "My Channel",
    "isSelected": true                      // ← the channel picked in the app
  },
  "UC…another channel…": { … }
}

If you have several channels, use the entry with "isSelected": true, or the one whose name matches the channel you want.

Good to Know

• The channel ID is the YouTube channel ID that starts with UC. The session ID is created by Creator Tools when you connect the channel.
• A channel connection lasts about three months. If you get 403 No credentials for channel, remove the channel in the app, add it again, and copy the new session ID.
• Logging out of the app ends the session, so the old session ID stops working.

Start a Translation

POST https://api.creator-tools.com/info/longterm-job

Headers: Content-Type: application/json and x-api-key: <gateway key>.

What Gets Translated

• With videoId: the video's title and description, plus subtitles if capturesIncluded is true.
• Without videoId: the channel's name and description.

Request Fields

Example: One Video with Subtitles

curl -X POST https://api.creator-tools.com/info/longterm-job \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: <GATEWAY_KEY>' \
  -d '{
    "xApiKey": "<PERSONAL_KEY>",
    "requestType": "startTranslationJob",
    "sessionId": "<SESSION_ID>",
    "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx",
    "videoId": "dQw4w9WgXcQ",
    "languages": ["es", "de", "fr", "pt-BR", "ja"],
    "capturesIncluded": true,
    "rewrite": false,
    "saveHashtags": true,
    "excludedFromTranslate": false,
    "useDialects": false,
    "tone": "default",
    "provider": "openai",
    "isPoetry": false,
    "aiTranslations": true
  }'

Reply

A 200 reply describes the new job. Keep the jobId: you need it to check the job.

{
  "jobId": "3f1c2a0e-7b8d-4c1e-9a55-…",
  "jobType": "translate",
  "videoId": "dQw4w9WgXcQ",
  "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx",
  "status": "IN_PROGRESS",
  "languages": ["es", "de", "fr", "pt-BR", "ja"],
  "startDate": "2026-09-30T10:15:00.000Z"
}

Check the Job Status

POST https://api.creator-tools.com/info/longterm-job, with the same headers as above.

{
  "xApiKey": "<PERSONAL_KEY>",
  "requestType": "getJobById",
  "jobId": "3f1c2a0e-7b8d-4c1e-9a55-…"
}

The 200 reply is the job, or null if you have no job with that ID.

{
  "jobId": "3f1c2a0e-…",
  "jobType": "translate",
  "status": "FINISHED",
  "startDate": "2026-09-30T10:15:00.000Z",
  "finishDate": "2026-09-30T10:16:12.000Z",
  "languages": ["es", "de", "fr", "pt-BR", "ja"],
  "languagesToTranslateVideo": ["es", "de", "fr", "pt-BR", "ja"],
  "languagesToTranslateCaptions": ["es", "de", "fr", "pt-BR", "ja"],
  "response": {
    "status": "translated",
    "captionsTranslated": true,
    "metadataLanguagesTranslated": 5,
    "captionsLanguageTranslated": 5
  }
}

Status Values

• How often to check: every 5 seconds. The app stops waiting after 50 minutes.
• No progress percentage: translation jobs report only their status.
• All your jobs: send "requestType": "getAllJobs" with your xApiKey to list every job.
• How long jobs are kept: a finished job can be read for 60 days.

Errors

An error reply has the form {"message": "…"}.

Full Example in JavaScript

const API = "https://api.creator-tools.com/info/longterm-job";
const GATEWAY_KEY = "<GATEWAY_KEY>";
const xApiKey = "<PERSONAL_KEY>";
const sessionId = "<SESSION_ID>";
const channelId = "UC…";

// Start one job. Start the next video only after this one is FINISHED or FAILED.
const job = await post({
  xApiKey, requestType: "startTranslationJob", sessionId, channelId,
  videoId: "dQw4w9WgXcQ", languages: ["es", "de", "fr"], capturesIncluded: true,
});

// Check every 5 seconds until the job is done.
let status;
do {
  await new Promise((resolve) => setTimeout(resolve, 5000));
  status = await post({ xApiKey, requestType: "getJobById", jobId: job.jobId });
} while (status && status.status !== "FINISHED" && status.status !== "FAILED");

console.log(status.status, status.response ?? status.reason);

async function post(body) {
  const res = await fetch(API, {
    method: "POST",
    headers: { "Content-Type": "application/json", "x-api-key": GATEWAY_KEY },
    body: JSON.stringify(body),
  });
  if (!res.ok) throw new Error((await res.json()).message);
  return res.json();
}

Languages and Codes

• Send the codes in languages exactly as written below. They follow YouTube's codes, so Hebrew is iw, Latin American Spanish is es-419, and Cantonese is yue.
• Channel means the code can also be used to translate a channel (a request without videoId). Other codes are skipped for channels. The channel list also accepts en-UK, fil and nb.