TikTok Data API: Profiles, Videos, Comments and Hashtags as JSON

curl -s -H "Authorization: Bearer gs_your_key" \
  "https://gramscraper.com/api/tiktok/v1/user/by/username?username=khaby.lame"

{
  "users": {
    "127905465618821121": {
      "id": "127905465618821121",
      "uniqueId": "khaby.lame",
      "nickname": "Khabane lame",
      "signature": "Se vuoi ridere sei nel posto giusto",
      "verified": true,
      "privateAccount": false,
      "avatarLarger": "https://p16-sign-va.tiktokcdn.com/..."
    }
  },
  "stats": {
    "127905465618821121": {
      "followerCount": 162400000,
      "followingCount": 79,
      "heart": 2600000000,
      "heartCount": -1694967296,
      "videoCount": 1290
    }
  }
}

const BASE = "https://gramscraper.com/api/tiktok";
const KEY = process.env.GRAMSCRAPER_API_KEY;

async function tiktok(path, params) {
  const url = new URL(BASE + path);
  for (const [k, v] of Object.entries(params)) if (v != null) url.searchParams.set(k, v);
  const res = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } });
  if (!res.ok) throw new Error(`HTTP ${res.status} on ${path}`);
  return res.json();
}

async function getProfile(username) {
  const data = await tiktok("/v1/user/by/username", { username });
  const user = Object.values(data.users || {})[0];
  const stats = Object.values(data.stats || {})[0] || {};
  if (!user) return null;
  const likes = [stats.heart, stats.heartCount].find(n => typeof n === "number" && n >= 0) ?? null;
  return {
    username: user.uniqueId,
    followers: stats.followerCount,
    following: stats.followingCount,
    likes,
    videos: stats.videoCount,
    verified: !!user.verified,
    private: !!user.privateAccount
  };
}

console.log(await getProfile("khaby.lame"));

import os, requests

BASE = "https://gramscraper.com/api/tiktok"
HEADERS = {"Authorization": f"Bearer {os.environ['GRAMSCRAPER_API_KEY']}"}

r = requests.get(f"{BASE}/v1/media/by/url", headers=HEADERS,
                 params={"url": "https://www.tiktok.com/@creator/video/7680560012632018189"})
r.raise_for_status()
v = r.json()

s = v.get("stats", {})
print(v["id"], v.get("desc"))
print("plays", s.get("playCount"), "likes", s.get("diggCount"),
      "comments", s.get("commentCount"), "shares", s.get("shareCount"),
      "saves", s.get("collectCount"))
print("hashtags", [c["title"] for c in v.get("challenges", [])])

async function creatorVideos(username, maxPages = 3) {
  const profile = await tiktok("/v1/user/by/username", { username });
  const secUid = Object.values(profile.users || {})[0]?.secUid;
  if (!secUid) return [];

  const out = [];
  let cursor = null;
  for (let page = 0; page < maxPages; page++) {
    const data = await tiktok("/v2/user/medias/by/secUid", { secUid, max_cursor: cursor });
    for (const v of data.aweme_list || []) {
      const s = v.statistics || {};
      out.push({
        id: v.aweme_id,
        at: new Date(v.create_time * 1000).toISOString(),
        plays: s.play_count, likes: s.digg_count, comments: s.comment_count,
        shares: s.share_count, saves: s.collect_count,
        pinned: !!v.is_top
      });
    }
    if (!data.has_more) break;
    cursor = data.max_cursor;
  }
  return out;
}

async function allComments(videoId, maxPages = 10) {
  const out = [];
  let cursor = null;
  for (let page = 0; page < maxPages; page++) {
    const data = await tiktok("/v1/media/comments/by/id", { id: videoId, cursor });
    for (const c of data.comments || []) {
      out.push({
        user: c.user?.unique_id,
        text: c.text,
        likes: c.digg_count,
        replies: c.reply_comment_total,
        at: new Date(c.create_time * 1000).toISOString()
      });
    }
    if (!data.has_more) break;
    cursor = data.cursor;
  }
  return out;
}

const info = await tiktok("/v1/hashtag/info", { hashtag: "booktok" });
const tag = info.challengeInfo.challenge;
// statsV2 has exact counts as strings; stats is rounded and often says 0 videos
const exact = info.challengeInfo.statsV2 || {};
console.log(tag.id, tag.title, "videos:", Number(exact.videoCount), "views:", Number(exact.viewCount));

const page = await tiktok("/v1/hashtag/medias", { id: tag.id });
for (const v of page.itemList || []) {
  console.log(v.author?.uniqueId, v.stats?.playCount, v.desc?.slice(0, 60));
}
// next page: pass page.cursor while page.hasMore is true