ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

TikTok API на Python и Node.js: рабочие примеры

TikTok API for Business работает из Python или Node.js через обычные HTTPS-запросы: каждый вызов отправляется на https://business-api.tiktok.com/open_api/v1.3 с токеном аккаунта в заголовке Access-Token и его open_id в качестве business_id. TikTok отвечает на большинство вызовов кодом HTTP 200 и полем code, где 0 означает успех, поэтому проверяйте его и делайте паузу 5 минут при коде 40100.

easyCoexistence даёт Claude, ChatGPT или вашему коду те же задачи TikTok как инструменты: от publish_tiktok_post и reply_to_comment до get_social_insights, а вашим скриптам выдаёт актуальный токен через get_social_credentials или Partner API.

HTTP 200

Статус большинства ответов TikTok, включая ошибки: только код 0 в теле означает, что вызов прошёл.

40100

Код для ограниченного вызова: TikTok просит паузу 5 минут после лимита в минуту и до 00:00 UTC после дневного лимита.

5xx

Ошибки сервера, после которых TikTok советует подождать около 5 минут перед повторным вызовом.

Final /

Пути заканчиваются слешем; TikTok указывает /tt_user/oauth2/refresh_token без него как причину ошибки 404 page not found.

3 languages

Python, JavaScript и Java входят в SDK TikTok API for Business, в списке эндпоинтов которого нет эндпоинта /business/.

HMAC-SHA256

Подпись в заголовке Tiktok-Signature каждого вебхука: вычисляется по метке времени, точке и телу запроса с ключом из секрета приложения.

Что нужно каждому вызову TikTok API?

Одни и те же пять вещей, какой бы ни была задача:

  • Базовый адрес https://business-api.tiktok.com/open_api/v1.3 и путь, который заканчивается слешем, например /business/video/list/.
  • Токен аккаунта в заголовке Access-Token, который обновляется до истечения 24 часов.
  • business_id, то есть open_id аккаунта: в строке запроса при GET и в теле JSON при POST.
  • Параметры списков и объектов при GET, например fields и filters, передаются как текст JSON: fields=["item_id","caption"].
  • Проверка code в ответе, так как TikTok присылает ошибки, например 40002 или 40100, с HTTP 200, а данные есть только при code 0.

Как обрабатывать конверт ошибки TikTok в Python?

Небольшой клиент подставляет business_id туда, где его ждёт каждый метод, возвращает data при code 0 и выбрасывает TikTokError в остальных случаях. Ограниченный вызов он повторяет после паузы TikTok в 5 минут, так как 40100 означает, что TikTok отказал в вызове. Ответ 5xx он повторяет только для GET, потому что публикация, завершившаяся ошибкой сервера, могла всё же дойти до TikTok. Нужен requests, и последующие примеры на Python используют этот клиент:

Python: a TikTok client that reads the envelope
import json
import os
import time

import requests

API = "https://business-api.tiktok.com/open_api/v1.3"


class TikTokError(Exception):
    def __init__(self, code, message, request_id):
        super().__init__(f"TikTok {code}: {message} (request_id {request_id})")
        self.code = code


class TikTok:
    """One TikTok account: its access token and its business_id, the open_id."""

    def __init__(self, access_token, business_id, pause=300):
        self.http = requests.Session()
        self.http.headers["Access-Token"] = access_token
        self.business_id = business_id
        self.pause = pause  # TikTok's advice after a 40100 or a 5xx: about 5 minutes

    def call(self, method, path, params=None, body=None, tries=3):
        for attempt in range(1, tries + 1):
            if method == "GET":
                query = {"business_id": self.business_id}
                for key, value in (params or {}).items():
                    is_json = isinstance(value, (list, dict))
                    query[key] = json.dumps(value, separators=(",", ":")) if is_json else value
                res = self.http.get(f"{API}/{path}", params=query, timeout=30)
            else:
                payload = {"business_id": self.business_id, **(body or {})}
                res = self.http.post(f"{API}/{path}", json=payload, timeout=30)
            if res.status_code >= 500 and method == "GET" and attempt < tries:
                time.sleep(self.pause)  # a POST is not repeated: it may have reached TikTok
                continue
            res.raise_for_status()  # a 4xx: a wrong path or method, such as a missing final slash
            answer = res.json()
            if answer.get("code") == 0:
                return answer.get("data") or {}
            if answer.get("code") == 40100 and attempt < tries:
                time.sleep(self.pause)  # throttled: TikTok refused the call, so repeating it is safe
                continue
            raise TikTokError(answer.get("code"), answer.get("message"), answer.get("request_id"))


tt = TikTok(os.environ["TIKTOK_ACCESS_TOKEN"], os.environ["TIKTOK_BUSINESS_ID"])

Как это сделать в Node.js?

Тот же клиент на fetch, встроенном в Node.js 18 и новее, без установки чего-либо. Он кодирует параметры списков в JSON для GET, помещает business_id в тело для POST и сохраняет code TikTok в ошибке, чтобы вызывающий код отличал 40102 или 40105, проблему с токеном, от 40001, отсутствующего разрешения:

Node.js: the same client on the built-in fetch
const API = "https://business-api.tiktok.com/open_api/v1.3";
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

class TikTokError extends Error {
  constructor(code, message, requestId) {
    super("TikTok " + code + ": " + message + " (request_id " + requestId + ")");
    this.code = code;
  }
}

// One TikTok account: its access token and its business_id, the open_id.
class TikTok {
  constructor(accessToken, businessId, pauseMs = 300000) {
    this.accessToken = accessToken;
    this.businessId = businessId;
    this.pauseMs = pauseMs; // TikTok's advice after a 40100 or a 5xx: about 5 minutes
  }

  async call(method, path, { params = {}, body = {} } = {}, tries = 3) {
    for (let attempt = 1; ; attempt++) {
      const url = new URL(API + "/" + path);
      const init = { method, headers: { "Access-Token": this.accessToken } };
      if (method === "GET") {
        url.searchParams.set("business_id", this.businessId);
        for (const [key, value] of Object.entries(params)) {
          url.searchParams.set(key, typeof value === "object" ? JSON.stringify(value) : String(value));
        }
      } else {
        init.headers["Content-Type"] = "application/json";
        init.body = JSON.stringify({ business_id: this.businessId, ...body });
      }
      const res = await fetch(url, init);
      if (res.status >= 500 && method === "GET" && attempt < tries) {
        await sleep(this.pauseMs); // a POST is not repeated: it may have reached TikTok
        continue;
      }
      if (!res.ok) throw new Error("HTTP " + res.status + " on " + path + ": check the path, its final slash and the method");
      const answer = await res.json();
      if (answer.code === 0) return answer.data ?? {};
      if (answer.code === 40100 && attempt < tries) {
        await sleep(this.pauseMs); // throttled: TikTok refused the call, so repeating it is safe
        continue;
      }
      throw new TikTokError(answer.code, answer.message, answer.request_id);
    }
  }
}

const tt = new TikTok(process.env.TIKTOK_ACCESS_TOKEN, process.env.TIKTOK_BUSINESS_ID);

Как опубликовать видео по ссылке и проверить его статус?

POST /business/video/publish/ с video_url и post_info, затем опрос /business/publish/status/ с share_id как publish_id. Цикл останавливается при FAILED с причиной от TikTok, а при PUBLISH_COMPLETE продолжает ждать, пока не придёт post_ids, на что TikTok указывает до трёх дополнительных минут. video_url должен находиться на домене или префиксе URL, подтверждённом для вашего приложения:

Publish a video and wait until it is public: Python, then Node.js
# Python
def wait_until_live(tt, share_id, interval=30, give_up_after=7200):
    deadline = time.time() + give_up_after
    while time.time() < deadline:
        status = tt.call("GET", "business/publish/status/", params={"publish_id": share_id})
        if status["status"] == "FAILED":
            raise RuntimeError(f"TikTok did not publish {share_id}: {status.get('reason')}")
        if status["status"] == "PUBLISH_COMPLETE" and status.get("post_ids"):
            return status["post_ids"]
        time.sleep(interval)  # post_ids can follow PUBLISH_COMPLETE by up to three minutes
    raise TimeoutError(f"{share_id} was not public after {give_up_after} s")


video = tt.call("POST", "business/video/publish/", body={
    "video_url": "https://media.example.com/tiktok/launch.mp4",  # on a verified domain or URL prefix
    "post_info": {
        "caption": "Our spring menu is live #food",
        "is_brand_organic": True,  # the Promotional content label, for the account's own business
        "is_branded_content": False,
    },
})
print("Live:", wait_until_live(tt, video["share_id"]))

// Node.js
async function waitUntilLive(tt, shareId, everyMs = 30000, giveUpAfterMs = 7200000) {
  const deadline = Date.now() + giveUpAfterMs;
  while (Date.now() < deadline) {
    const s = await tt.call("GET", "business/publish/status/", { params: { publish_id: shareId } });
    if (s.status === "FAILED") throw new Error("TikTok did not publish " + shareId + ": " + s.reason);
    if (s.status === "PUBLISH_COMPLETE" && s.post_ids && s.post_ids.length) return s.post_ids;
    await sleep(everyMs); // post_ids can follow PUBLISH_COMPLETE by up to three minutes
  }
  throw new Error(shareId + " was not public after " + giveUpAfterMs / 1000 + " s");
}

async function publishVideo(tt) {
  const video = await tt.call("POST", "business/video/publish/", {
    body: {
      video_url: "https://media.example.com/tiktok/launch.mp4", // on a verified domain or URL prefix
      post_info: { caption: "Our spring menu is live #food", is_brand_organic: true, is_branded_content: false },
    },
  });
  return waitUntilLive(tt, video.share_id);
}

publishVideo(tt).then((postIds) => console.log("Live:", postIds), console.error);

Как опубликовать фото?

Сначала прочитайте разрешённые настройки аккаунта, затем POST /business/photo/publish/. Публикация фото требует privacy_level, который должен быть одним из privacy_level_options из /business/video/settings/, и если там comment_disabled равно true, то disable_comment тоже должен быть true. Возвращённый share_id опрашивается той же функцией ожидания, что и видео:

Publish a photo post: Python, then Node.js
# Python
def publish_photos(tt, image_urls, title, caption):
    settings = tt.call("GET", "business/video/settings/")
    if "PUBLIC_TO_EVERYONE" not in settings["privacy_level_options"]:
        raise RuntimeError(f"Private account, choose from {settings['privacy_level_options']}")
    photo = tt.call("POST", "business/photo/publish/", body={
        "photo_images": image_urls,  # 1 to 35 JPG, JPEG or WebP links on a verified domain or prefix
        "photo_cover_index": 0,
        "post_info": {
            "title": title,  # up to 90 UTF-16 code units
            "caption": caption,  # up to 4,000
            "privacy_level": "PUBLIC_TO_EVERYONE",
            "disable_comment": settings["comment_disabled"],  # True when the account takes no comments
            "is_brand_organic": True,
            "is_branded_content": False,
        },
    })
    return wait_until_live(tt, photo["share_id"])


print(publish_photos(tt, ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"],
                     "Spring menu", "Four new dishes, from Friday #food"))

// Node.js
async function publishPhotos(tt, imageUrls, title, caption) {
  const settings = await tt.call("GET", "business/video/settings/");
  if (!settings.privacy_level_options.includes("PUBLIC_TO_EVERYONE")) {
    throw new Error("Private account, choose from " + settings.privacy_level_options.join(", "));
  }
  const photo = await tt.call("POST", "business/photo/publish/", {
    body: {
      photo_images: imageUrls, // 1 to 35 JPG, JPEG or WebP links on a verified domain or prefix
      photo_cover_index: 0,
      post_info: {
        title, // up to 90 UTF-16 code units
        caption, // up to 4,000
        privacy_level: "PUBLIC_TO_EVERYONE",
        disable_comment: settings.comment_disabled, // true when the account takes no comments
        is_brand_organic: true,
        is_branded_content: false,
      },
    },
  });
  return waitUntilLive(tt, photo.share_id);
}

publishPhotos(tt, ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"],
  "Spring menu", "Four new dishes, from Friday #food").then(console.log, console.error);

Как получить список видео аккаунта?

GET /business/video/list/ с нужными полями, среди которых item_id, до 20 публикаций на страницу от новых к старым. Передавайте возвращённый cursor, метку времени UTC в миллисекундах, пока has_more равно true, и ждите коротких страниц: правила безопасности TikTok могут вернуть меньше max_count до конца списка.

List recent videos across pages: Python, then Node.js
# Python
def recent_videos(tt, how_many=60):
    params = {"fields": ["item_id", "create_time", "caption", "share_url", "video_views", "likes", "comments"],
              "max_count": 20}
    videos = []
    while len(videos) < how_many:
        page = tt.call("GET", "business/video/list/", params=params)
        videos += page.get("videos", [])
        if not page.get("has_more"):
            break
        params["cursor"] = page["cursor"]  # posts published before this UTC time, in milliseconds
    return videos[:how_many]


for v in recent_videos(tt):
    print(v["item_id"], v.get("video_views"), (v.get("caption") or "")[:60])

// Node.js
async function recentVideos(tt, howMany = 60) {
  const params = {
    fields: ["item_id", "create_time", "caption", "share_url", "video_views", "likes", "comments"],
    max_count: 20,
  };
  const videos = [];
  while (videos.length < howMany) {
    const page = await tt.call("GET", "business/video/list/", { params });
    videos.push(...(page.videos ?? []));
    if (!page.has_more) break;
    params.cursor = page.cursor; // posts published before this UTC time, in milliseconds
  }
  return videos.slice(0, howMany);
}

recentVideos(tt).then((videos) => {
  for (const v of videos) console.log(v.item_id, v.video_views, (v.caption || "").slice(0, 60));
}, console.error);

Как читать комментарии и отвечать на них?

GET /business/comment/list/ с item_id публикации как video_id возвращает до 30 комментариев на страницу, а POST /business/comment/reply/create/ публично отвечает на один из них текстом до 1 200 символов. Пример отвечает на комментарии верхнего уровня без ответов, пропускает комментарии самого аккаунта и оставляет формулировки функции, которую вы пишете, так как TikTok может скрыть почти одинаковые комментарии, оставленные подряд, как спам:

Reply to new comments on a video: Python, then Node.js
# Python
def reply_to_new_comments(tt, video_id, write_reply):
    page = tt.call("GET", "business/comment/list/", params={
        "video_id": video_id,  # the post's item_id
        "status": "PUBLIC",
        "sort_field": "create_time",
        "sort_order": "desc",
        "max_count": 30,
    })
    for comment in page.get("comments", []):
        if comment.get("owner") or comment.get("replies") or comment.get("parent_comment_id"):
            continue  # the account's own comments, threads with replies, and replies
        text = write_reply(comment)
        if text:
            tt.call("POST", "business/comment/reply/create/", body={
                "video_id": video_id, "comment_id": comment["comment_id"], "text": text,  # up to 1,200 characters
            })


def reply_for(comment):
    if "price" in (comment.get("text") or "").lower():
        return f"Hi {comment.get('display_name') or 'there'}, the price list is pinned on our profile."
    return None  # leave the rest to a person


reply_to_new_comments(tt, "<ITEM_ID>", reply_for)

// Node.js
async function replyToNewComments(tt, videoId, writeReply) {
  const page = await tt.call("GET", "business/comment/list/", {
    params: { video_id: videoId, status: "PUBLIC", sort_field: "create_time", sort_order: "desc", max_count: 30 },
  });
  for (const comment of page.comments ?? []) {
    if (comment.owner || comment.replies || comment.parent_comment_id) continue; // own, already replied to, or a reply
    const text = writeReply(comment);
    if (text) {
      await tt.call("POST", "business/comment/reply/create/", {
        body: { video_id: videoId, comment_id: comment.comment_id, text }, // up to 1,200 characters
      });
    }
  }
}

function replyFor(comment) {
  if ((comment.text || "").toLowerCase().includes("price")) {
    return "Hi " + (comment.display_name || "there") + ", the price list is pinned on our profile.";
  }
  return null; // leave the rest to a person
}

replyToNewComments(tt, "<ITEM_ID>", replyFor).catch(console.error);

Как читать аналитику аккаунта?

GET /business/get/ с именами полей в fields и диапазоном дат UTC до 60 дней. followers_count приходит дважды: текущий итог вверху data и итог за каждый день внутри metrics, рядом с video_views, profile_views, likes, comments и shares за этот день. Пример заканчивается вчерашним днём, так как дневные показатели приходят с задержкой 24–48 часов:

Daily account metrics for the last 7 days: Python, then Node.js
# Python
from datetime import datetime, timedelta, timezone


def daily_insights(tt, days=7):
    yesterday = datetime.now(timezone.utc).date() - timedelta(days=1)  # counts arrive 24 to 48 h late
    data = tt.call("GET", "business/get/", params={
        "fields": ["followers_count", "video_views", "profile_views", "likes", "comments", "shares"],
        "start_date": (yesterday - timedelta(days=days - 1)).isoformat(),  # UTC, up to 60 days back
        "end_date": yesterday.isoformat(),
    })
    print("Followers now:", data.get("followers_count"))
    for day in data.get("metrics", []):
        print(day["date"], day.get("followers_count"), day.get("video_views"), day.get("likes"))


daily_insights(tt)

// Node.js
async function dailyInsights(tt, days = 7) {
  const utcDay = (daysAgo) => new Date(Date.now() - daysAgo * 86400000).toISOString().slice(0, 10);
  const data = await tt.call("GET", "business/get/", {
    params: {
      fields: ["followers_count", "video_views", "profile_views", "likes", "comments", "shares"],
      start_date: utcDay(days), // UTC, up to 60 days back
      end_date: utcDay(1), // counts arrive 24 to 48 h late
    },
  });
  console.log("Followers now:", data.followers_count);
  for (const day of data.metrics ?? []) console.log(day.date, day.followers_count, day.video_views, day.likes);
}

dailyInsights(tt).catch(console.error);

Как проверить подпись вебхука?

Пересчитайте HMAC-SHA256 от значения t, точки и исходного тела запроса, с ключом из секрета приложения, сравните с s методом постоянного времени и проверьте, что t свежее. Читайте тело как байты до того, как что-либо его разберёт, сразу отвечайте 200 и записывайте x-tt-logid при неудачной проверке. Flask для Python и встроенный модуль http для Node.js:

Receive a signed TikTok webhook: Python with Flask, then Node.js
# Python
import hashlib
import hmac
import json
import os
import time
from queue import Queue

from flask import Flask, request

app = Flask(__name__)
events = Queue()


def signature_ok(raw, header, secret, max_age=300):
    fields = {}
    for part in (header or "").split(","):
        key, sep, value = part.strip().partition("=")
        if sep:
            fields[key] = value
    t, s = fields.get("t", ""), fields.get("s", "").lower()
    if not t.isdigit() or len(s) != 64:
        return False
    expected = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, s) and abs(time.time() - int(t)) <= max_age


@app.post("/tiktok/webhook")
def tiktok_webhook():
    raw = request.get_data()  # the bytes TikTok signed, before any JSON parsing
    if not signature_ok(raw, request.headers.get("Tiktok-Signature"), os.environ["TIKTOK_APP_SECRET"]):
        app.logger.warning("Bad signature, x-tt-logid %s", request.headers.get("X-Tt-Logid"))
        return "", 401
    events.put(json.loads(raw))  # its content field is itself a JSON string: work on it elsewhere
    return "", 200

// Node.js
const { createServer } = require("node:http");
const { createHmac, timingSafeEqual } = require("node:crypto");

function signatureOk(raw, header, secret, maxAgeSec = 300) {
  const fields = {};
  for (const part of String(header ?? "").split(",")) {
    const i = part.indexOf("=");
    if (i > 0) fields[part.slice(0, i).trim()] = part.slice(i + 1).trim();
  }
  if (!/^\d+$/.test(fields.t ?? "") || !/^[0-9a-f]{64}$/i.test(fields.s ?? "")) return false;
  const expected = createHmac("sha256", secret).update(fields.t + ".").update(raw).digest();
  const fresh = Math.abs(Date.now() / 1000 - Number(fields.t)) <= maxAgeSec;
  return timingSafeEqual(expected, Buffer.from(fields.s, "hex")) && fresh;
}

const inbox = [];
createServer((req, res) => {
  if (req.method !== "POST" || req.url !== "/tiktok/webhook") return res.writeHead(404).end();
  const chunks = [];
  req.on("data", (chunk) => chunks.push(chunk));
  req.on("end", () => {
    const raw = Buffer.concat(chunks); // the bytes TikTok signed
    if (!signatureOk(raw, req.headers["tiktok-signature"], process.env.TIKTOK_APP_SECRET)) {
      console.warn("Bad signature, x-tt-logid", req.headers["x-tt-logid"]);
      return res.writeHead(401).end();
    }
    res.writeHead(200).end(); // answer first: TikTok retries anything but a 200 for up to 72 hours
    inbox.push(JSON.parse(raw.toString("utf8")));
  });
}).listen(3000);

Как выполнить те же задачи через easyCoexistence?

Как вызовы инструментов из Claude, ChatGPT или другого MCP-клиента, подключённого к https://easycoexistence.com/api/mcp, каждый с account_id из list_social_accounts. easyCoexistence отправляет ваши ссылки на медиа в TikTok через собственный подтверждённый префикс URL, отслеживает каждую публикацию до завершения или ошибки TikTok и обновляет токен, а отклонённый вызов возвращается с кодом и сообщением TikTok:

The six jobs as MCP tool calls
// Publish a video by URL, then see where it stands
publish_tiktok_post { "account_id": "<ACCOUNT_ID>", "video_url": "https://media.example.com/tiktok/launch.mp4", "caption": "Our spring menu is live #food" }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "<SHARE_ID>" }

// Post photos
publish_tiktok_post { "account_id": "<ACCOUNT_ID>", "image_urls": ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"], "title": "Spring menu", "caption": "Four new dishes, from Friday #food" }

// List videos
list_social_posts { "account_id": "<ACCOUNT_ID>", "limit": 20 }

// Read comments and reply in public
list_social_comments { "account_id": "<ACCOUNT_ID>", "post_id": "<ITEM_ID>" }
reply_to_comment { "account_id": "<ACCOUNT_ID>", "post_id": "<ITEM_ID>", "comment_id": "<COMMENT_ID>", "text": "The price list is pinned on our profile." }

// Account insights
get_social_insights { "account_id": "<ACCOUNT_ID>", "metrics": ["followers_count", "video_views", "likes"], "params": { "start_date": "2026-10-26", "end_date": "2026-11-01" } }

// Comment events, signed by easyCoexistence, at your endpoint
set_social_webhook_destination { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/tiktok/" }

Как ваш собственный код использует аккаунт, подключённый к easyCoexistence?

Получайте учётные данные аккаунта для каждой задачи из Partner API и передавайте их тому же клиенту. GET /channels/{id}?credentials=1 с вашим ключом ec_live_ возвращает api_base, business_id и актуальный access_token с token_expires_at, либо null вместо токена с примечанием, если канал нужно подключить заново. Чтение, ответы и аналитика затем выполняются из вашего кода, а публикации идут через POST /channels/{id}/posts или publish_tiktok_post, которые направляют медиа через подтверждённый префикс:

A current token from the Partner API, into the same client: Python, then Node.js
# Python
def tiktok_for(channel_id):
    res = requests.get(f"https://easycoexistence.com/api/v1/channels/{channel_id}", params={"credentials": "1"},
                       headers={"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}, timeout=30)
    res.raise_for_status()
    creds = res.json()["credentials"]
    if not creds.get("access_token"):
        raise RuntimeError(creds.get("note"))  # the channel needs reconnecting
    return TikTok(creds["access_token"], creds["business_id"])


print(recent_videos(tiktok_for("<CHANNEL_ID>"), 20))

// Node.js
async function tiktokFor(channelId) {
  const res = await fetch("https://easycoexistence.com/api/v1/channels/" + channelId + "?credentials=1", {
    headers: { Authorization: "Bearer " + process.env.EC_API_KEY },
  });
  if (!res.ok) throw new Error("HTTP " + res.status + " from easyCoexistence");
  const { credentials } = await res.json();
  if (!credentials.access_token) throw new Error(credentials.note); // the channel needs reconnecting
  return new TikTok(credentials.access_token, credentials.business_id);
}

tiktokFor("<CHANNEL_ID>").then((account) => recentVideos(account, 20)).then(console.log, console.error);

Распространённые ошибки

  • Чтение данных без проверки code. Ответ может прийти с HTTP 200, кодом 40002 и без данных вообще, поэтому отсутствующее поле часто означает ошибку, которую код пропустил.
  • Потеря завершающего слеша. Пути TikTok заканчиваются на /, а в приложении с кодами возврата указан /tt_user/oauth2/refresh_token без слеша как вызов, который завершается HTTP 404 page not found.
  • Получение ID ответов из reply_list в Node.js. Справочник TikTok описывает comment_id и video_id в reply_list как числа, которые JSON.parse может округлить; /business/comment/reply/list/ возвращает их строками.
  • Передача fields списком через запятую. API for Business ожидает текст JSON: fields=["item_id","caption"], в отличие от Display API на developers.tiktok.com, который принимает fields=open_id,union_id.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений цена снижается, первые 3 дня бесплатно.

Часто задаваемые вопросы

У TikTok есть официальный SDK для Python или Node.js для Accounts API?

SDK TikTok API for Business выпускается на Python, JavaScript и Java, но его список эндпоинтов охватывает рекламу, отчёты и Business Center, без эндпоинтов /business/ или /tt_user/.

Почему вызов TikTok возвращает HTTP 200 без данных?

TikTok сообщает об ошибках в поле code ответа HTTP 200. Читайте code и message: 40002 означает ошибку параметра, 40001 отсутствующее разрешение, а 40100 ограниченный вызов.

Какие версии Python и Node.js нужны этим примерам?

Python 3.9 или новее с requests и Flask для вебхука, а также Node.js 18 или новее, чьи встроенные fetch и node:crypto покрывают остальное.

Можно ли вызывать TikTok API из браузера?

Держите вызовы на своём сервере. Тип токена TikTok это Bearer, которым может воспользоваться любой, у кого он есть, а эндпоинты токенов требуют client_secret вашего приложения.

Читайте дальше

Руководство по TikTok API на 2026 год: от приложения до первого постаПуть через TikTok API в 2026 году: выбор API, проверка приложения, разрешения, токены, публикация, статус, комментарии, вебхуки, аналитика, лимиты.Изменения TikTok API в 2026 году: что перестало работать и что делатьИзменения TikTok API в 2026 году, от новых к старым: сроки токенов, is_business_account, лимиты комментариев, форма доступа и песочница, с решением каждой.Почему подключение TikTok API перестаёт работать и как его поддерживатьПочему подключение TikTok API for Business прерывается: токен на 24 часа, токен обновления на год, отозванный доступ, смена аккаунта и как переподключить.Как опубликовать видео в TikTok через APIПубликуйте видео в TikTok через API for Business: эндпоинт публикации, тело JSON, share_id из ответа и проверка статуса в curl и Python.Проверка вебхуков TikTok: заголовок подписи и как его проверитьПроверка вебхука TikTok API for Business: заголовок Tiktok-Signature, HMAC-SHA256 от t, точки и тела запроса с секретом приложения, на Node.js.Лимиты TikTok API: запросы на аккаунт, приложение и эндпоинтЛимиты TikTok API: 40 запросов в минуту на аккаунт и эндпоинт, 600 или 1 000 в минуту на приложение в Accounts API и четыре уровня приложения.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на