Skip to content

How to get TikTok video stats (views, likes, shares) with an API

Updated · 2 steps

Every public TikTok video has a play count, likes, comments, shares and saves. Fetchproof returns them from a video URL, or for a whole profile page by page, so you can track campaign performance or rank a creator's videos without a TikTok developer app.

Both calls put the counts in the same statistics object, so one parser covers single videos and whole profiles.

01

Get one video's stats

Pass a video or slideshow URL. The counts are in aweme_detail.statistics: play_count, digg_count (likes), comment_count, share_count, collect_count (saves) and repost_count. The response also carries the caption in desc, the post time in create_time, the author with their follower count, and the music.

Add get_transcript=true to include the video's own captions as WebVTT at no extra cost. Video files are in video.play_addr.

GET /v2/tiktok/video 1 credit per call

cURL

curl --request GET 'https://api.fetchproof.com/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40nasa%2Fvideo%2F7708867568920038669' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40nasa%2Fvideo%2F7708867568920038669", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40nasa%2Fvideo%2F7708867568920038669",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40nasa%2Fvideo%2F7708867568920038669", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40nasa%2Fvideo%2F7708867568920038669");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Excerpt of published sample response Full response →
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "aweme_detail": {
    "added_sound_music_info": {
      "album": "Retro Sounds",
      "author": "DreamyBeats",
      "cover_large": "{…}",
      "cover_medium": "{…}",
      "cover_thumb": "{…}",
      "duration": 117,
      "id_str": "7417137492757612560",
      "is_original": false,
      "is_original_sound": false,
      "play_url": "{…}",
      "title": "Retro Sounds"
    },
    "author": {
      "avatar_larger": "{…}",
      "avatar_medium": "{…}",
      "avatar_thumb": "{…}",
      "aweme_count": 67,
      "comment_setting": 0,
      "create_time": 1784562949,
      "download_setting": 0,
      "duet_setting": 0,
      "favoriting_count": 367,
      "follower_count": 2200000,
      "following_count": 23,
      "nickname": "NASA",
      "…": "7 more fields"
    },
    "aweme_id": "7708867568920038669",
    "create_time": 1794860611,
    "desc": "Could you be a NASA astronaut? 👀 Our astronaut candidates clear up a few myths about who …",
    "desc_language": "en",
    "is_ads": false,
    "music": {
      "album": "Retro Sounds",
      "author": "DreamyBeats",
      "cover_large": "{…}",
      "cover_medium": "{…}",
      "cover_thumb": "{…}",
      "duration": 117,
      "id_str": "7417137492757612560",
      "is_original": false,
      "is_original_sound": false,
      "play_url": "{…}",
      "title": "Retro Sounds"
    },
    "region": "US",
    "share_url": "https://www.tiktok.com/@nasa/video/7708867568920038669",
    "statistics": {
      "aweme_id": "7708867568920038669",
      "collect_count": 731,
      "comment_count": 160,
      "digg_count": 5583,
      "play_count": 33000,
      "repost_count": 0,
      "share_count": 198
    },
    "text_extra": [],
    "…": "3 more fields"
  },
  "status_code": 0
}
02

Get stats for every video on a profile

Pass a handle to get the profile's posts, newest first, 15 per page. Each item in aweme_list has the same statistics object. While has_more is true, send max_cursor from the response to get the next, older page.

Pinned posts are included by default. Set include_pinned=false to leave them out, and keep the same value while paging. Sorting by popularity isn't supported: sort_by=popular returns 400.

GET /v3/tiktok/profile/videos 1 credit per call

cURL

curl --request GET 'https://api.fetchproof.com/v3/tiktok/profile/videos?handle=nasa' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v3/tiktok/profile/videos?handle=nasa", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v3/tiktok/profile/videos?handle=nasa",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v3/tiktok/profile/videos?handle=nasa", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v3/tiktok/profile/videos?handle=nasa");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Excerpt of published sample response Full response →
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "aweme_list": [
    {
      "added_sound_music_info": "{…}",
      "author": "{…}",
      "aweme_id": "7708867568920038669",
      "create_time": 1794860611,
      "desc": "Could you be a NASA astronaut? 👀 Our astronaut candidates clear up a few myths about who …",
      "desc_language": "en",
      "is_ads": false,
      "music": "{…}",
      "share_url": "https://www.tiktok.com/@nasa/video/7708867568920038669",
      "statistics": "{…}",
      "video": "{…}",
      "create_time_utc": "2026-11-16T20:23:31.000Z",
      "…": "1 more fields"
    }
  ],
  "extra": {
    "fatal_item_ids": [],
    "logid": "20261117020518D321FCB320200930686F",
    "now": 1794881119000
  },
  "has_more": 1,
  "log_pb": {
    "impr_id": "20261117020518D321FCB320200930686F"
  },
  "max_cursor": 1790970924000,
  "min_cursor": 1794881118750,
  "status_code": 0
}

What it costs

Each call costs 1 credit, whether it returns one video or a page of 15. Errors cost 0 credits. On the single-video call, cache_max_age serves a recent cached copy for 0 credits; leave it off when you need today's numbers. The profile videos call is always fetched live.

Limits

Only public videos and profiles are available. A video that isn't found hasn't necessarily been deleted. Counts are what TikTok shows publicly at the time of the call.

Try it with 100 free credits

Sign up with an email address, no card. Credits never expire. Errors cost 0 credits, and each endpoint page lists exactly what it charges.