python-tiktok
A simple Python wrapper around for Tiktok API ✨ 🍰 ✨.
This library provides a service to easily use TikTok official apis.
For now, include follows apis:
You can install this library easily by pypi:
$ pip install python-tiktokMore installing detail see Installation docs
You can see more usage detail at usage docs
Version Tips :
API for Business Version
1.3is now live! visit here for more details.Now this library set default version to
v1.3.And
v1.2will be deprecated on August 15, 2023.
If you have account access token, you can initialize api instance by it.
>>> from pytiktok import BusinessAccountApi
>>> business_api = BusinessAccountApi(access_token="Your Access Token")Or you can let account to give permission by OAuth flow. See business authorization docs
Now you can get account's data.
Get account profile:
>>> business_api.get_account_data(business_id="Business ID", return_json=True)
>>> # {'code':0,'message':'OK','request_id':'2022070106561301000400402500400500600301500A52386','data':{'display_name':'kiki','profile_image':'https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/accb4aeac4ec812e2bdc45ce1da1ed39~c5_168x168.jpeg?x-expires=1656828000&x-signature=MmXPWeImP%2BRGBwAOqN3wjPpDiZE%3D'}}If you set function parameter return_json to True, will return the json dict data. Otherwise will return a dataclass object representing the response.
Get account videos:
>>> business_api.get_account_videos(business_id="Business ID", return_json=True)
>>> # {'code':0,'message':'OK','request_id':'20220701071724010004003007735002053068B3FD9','data':{'videos':[{'item_id':'7108684822863760646'},{'item_id':'7109064881462152453'}],'has_more':False,'cursor':0}}If you have user access token, you can initialize api instance by it.
>>> from pytiktok import KitApi
>>> kit_api = KitApi(access_token="Your Access Token")Or you can let user to give permission by OAuth flow. See kit authorization docs
Now you can get account's data.
Get user info:
>>> kit_api.get_user_info(open_id="User Openid", return_json=True)
>>> # {'data':{'user':{'open_id':'open_id','union_id':'union_id','avatar_url':'https://p16-sign-sg.tiktokcdn.com/tiktok-obj/7046311066329939970~c5_168x168.jpeg?x-expires=1656907200&x-signature=w4%2FugSm2IOdma6p0D9V%2FZneIlPU%3D','display_name':'ki'}},'error':{'code':0,'message':''}}Get user videos:
>>> kit_api.get_user_videos(open_id="_000Hqnyyz5UYe39YWBZwFnaQGfyaoh3s4IY", return_json=True)
>>> # {'data':{'videos':[{'create_time':1654670085,'share_url':'https://www.tiktok.com/@klein_kunkun/video/7106753891953347842?utm_campaign=tt4d_open_api&utm_source=aw46lwwtsqjeapig','duration':5,'id':'7106753891953347842'},{'create_time':1654658105,'share_url':'https://www.tiktok.com/@klein_kunkun/video/7106702437926407426?utm_campaign=tt4d_open_api&utm_source=aw46lwwtsqjeapig','duration':6,'id':'7106702437926407426'}],'cursor':1654658105000,'has_more':False},'error':{'code':0,'message':''}}