TikTok-API-PHP

Unofficial TikTok API for PHP

Installation via Composer

composer require ssovit/tiktok-api

Usage

Follow examples in /example directory

$api=new \Sovit\TikTok\Api(array(/* config array*/));

$trendingFeed=$api->getTrendingFeed($maxCursor=0);

$userData=$api->getUser("tiktok");

$userFeed=$api->getUserFeed("tiktok",$maxCursor=0);

$challenge=$api->getChallenge("foryourpage");

$challengeFeed=$api->getChallengeFeed("foryourpage",$maxCursor=0);

$musc=$api->getMusic("6798898508385585925");

$musicFeed=$api->getMusicFeed("6798898508385585925",$maxCursor=0);

$videoData=$api->getVideoByID("6829540826570296577");

$videoData=$api->getVideoByUrl("https://www.tiktok.com/@zachking/video/6829303572832750853");

$noWatermark=$api->getNoWatermark("https://www.tiktok.com/@zachking/video/6829303572832750853");

Available Options

$api=new \Sovit\TikTok\Api(array(
	"user-agent"     => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.106 Safari/537.36',
	"proxy-host"     => false,
	"proxy-port"     => false,
	"proxy-username" => false,
	"proxy-password" => false,
	"cache-timeout"  => 3600 // 1 hours cache timeout
	"cookie_file"  => sys_get_temp_dir() . 'tiktok.txt' // cookie file, necessary for trending feed
	), $cache_engine=false);

#Cache Engine You can build your own engine that will store and fetch cache from your local storage to prevent frequent requests to TikTok server. This can help being banned from TikTok server for too frequent requests.

Cache engine should have callable get and set methods that the API class uses

// Example using WordPress transient as cache engine
Class MyCacheEngine{
	function get($cache_key){
		return get_transient($cache_key);
	}
	function set($cache_key,$data,$timeout=3600){
		return set_transient($cache_key,$data,$timeout);
	}
}

Usage

$cache_engine=new MyCacheEngine();
$api=new \Sovit\TikTok\Api(array(/* config array*/),$cache_engine);

Stream and Download videos

Follow examples on /example folder for video stream and download example Note: TikTok videos will not play directly when used in HTML video player as they require www.tiktok.com as http referrer.

Proxy Support

To use proxy, provide proxy-host, proxy-port, proxy-username, proxy-password It's highly recommended that you use proxy to prevent your IP from getting banned.

Available methods

getTrendingFeed - Get trending feed getUser($maxCursor)
getUser - Get profile data for TikTok User getUser($username)
getUserFeed - Get user feed by ID getUserFeed($user_id,$maxCursor)
getUserFeedByName - Get user feed by Name getUserFeedByName($username,$maxCursor)
getChallenge - Get challenge/hashtag info getChallenge($challenge)
getChallengeFeed - Get challenge feed by ID getChallengeFeed($challenge_id, $maxCursor)
getChallengeFeedByName - Get challenge feed by name getChallengeFeedByName($challenge,$maxCursor)
getMusic - Get music info getMusic($music_id)
getMusicFeed - Get music feed getMusicFeed($music_id,$maxCursor)
getVideoByID - Get video by ID getVideoByID($video_id)
getVideoByUrl - Get video by URL getVideoByUrl($video_url)
getNoWatermark - Get no watermark for video by URL getNoWatermark($video_url) (only works for videos before 28th July 2020)

$maxCursor defaults to 0, and is offset for results page. maxCursor for next page is exposed on current page call feed data.

TikTok videos don't have video id as meta data on watermarked video posted after ~24-28 July 2020. You can use the API service at https://rapidapi.com/ssovit/api/tiktok-no-watermark1 which provides cheap and reliable API service to fetch video ID for newer videos.

Want to improve this? Want to contribute?

Don't hesitate to create pull requests.

Disclaimer

TikTok is always updating their API endpoints but I will try to keep this library whenever possible. I take no responsibility if you or your IP gets banned using this API. It's recommended that you use proxy.

shapito27 / TikTok-API-PHP