import { TrendsMcpClient } from "tiktok-trends-api";

const client = new TrendsMcpClient({ apiKey: "YOUR_API_KEY" });

// 5-year weekly time series
const series = await client.getTrends({
  source: "tiktok",
  keyword: "BookTok",
});
console.log(series[0]);
// { date: "2026-03-28", value: 72, volume: null, keyword: "BookTok", source: "tiktok" }

// Period-over-period growth
const growth = await client.getGrowth({
  source: "tiktok",
  keyword: "BookTok",
  percent_growth: ["3M", "1Y"],
});
console.log(growth.results[0]);
// { period: "3M", growth: 14.5, direction: "increase", ... }

// What's trending right now
const trending = await client.getTopTrends({ limit: 10 });
console.log(trending.data);
// [[1, "topic one"], [2, "topic two"], ...]

import { TrendsMcpClient, TrendsMcpError } from "tiktok-trends-api";

try {
  const series = await client.getTrends({ source: "tiktok", keyword: "BookTok" });
} catch (err) {
  if (err instanceof TrendsMcpError) {
    console.error(err.status);  // 429
    console.error(err.code);    // "rate_limited"
    console.error(err.message);
  }
}