TikAPIs — Python SDK for TikTok Automation

The most powerful Python toolkit for TikTok automation. Register accounts, log in, interact with content, and manage real device sessions — all through the blazing-fast REST API at mobile-api.tikapis.com.

---

What Is TikAPIs?

TikAPIs is a clean, production-ready Python SDK that wraps the tikapis.com REST API. It lets you automate TikTok workflows programmatically — from account creation to content interaction — across every major platform.

Whether you are building a bulk account tool, an automation pipeline, or just need reliable TikTok API access, TikAPIs gives you a single, unified interface.

---

Supported Applications

Global Region — Android (30 apps)

AID	Display Name	Package
1233	TikTok	com.zhiliaoapp.musically
1180	TikTok (trill)	com.ss.android.ugc.trill
1340	TikTok Lite	com.zhiliaoapp.musically.go
473824	TikTok Lite	com.ss.android.ugc.tiktok.lite
385522	TikTok Now	com.ss.android.ugc.now
563145	TikTok Notes	com.ss.android.ugc.spark
567753	TikTok Studio	com.ss.android.tt.creator
7743	Seller Center	com.tiktokshop.seller
4082	TikTok (TV)	com.tiktok.tv
364225	Whee	com.bytedance.snail
318091	PICO	com.picovr.assistantphone.global
845221	PineDrama	com.ss.android.ttmd.video
310024	TikTok Music	com.tiktok.android.music
1811	Resso	com.moonvideo.android.resso
7356	Hypic	com.xt.retouchoversea
1372	ULike	com.gorgeous.liteinternational
580589	Lemon8	com.bd.nproject
7633	Fanno	com.fans.magellan.android
945965	Trae	com.bytedance.trae.overseas
3006	CapCut	com.lemon.lvoverseas
359289	CapCut (Pad)	com.lemon.ccpadpro
489823	Dola	com.larus.wolf
862354	Pippit	com.bytedance.pippitoverseas
791253	Dreamina AI	com.lemon.dreamina

Global Region — iOS/Apple (25 apps)

AID	Display Name	Package
1233	TikTok	com.zhiliaoapp.musically
1180	TikTok (trill)	com.ss.iphone.ugc.Ame
473824	TikTok Lite	com.ss.iphone.ugc.tiktok.lite
385522	TikTok Now	com.ss.iphone.ugc.now
364225	Whee	com.bytedance.snail
567753	TikTok Studio	com.ss.iphone.tt.creator
845221	PineDrama	com.ss.iphone.ttmd.video
791253	Dreamina AI	com.lemon.dreamina
1372	ULike	com.light.beautyabroad
7356	Hypic	com.xt.retouchoversea
3006	CapCut	com.lemon.lvoverseas
489823	Dola	com.bot.cici
862354	Pippit	com.bytedance.pippitoverseas

Global Region — Windows (1 app)

AID	Display Name	Package
8311	TikTok LIVE Studio	com.ss.windows.studio

China Region — Android (Douyin / ByteDance)

AID	Display Name	App Name
1128	抖音 / Douyin	aweme
8663	抖音火山版 / Douyin Hotsoon	aweme_hotsoon
2329	抖音极速版 / Douyin Lite	douyin_lite
547599	抖音直播伴侣 / Douyin LivePro	livepro
8478	汽水音乐 / Luna Music	luna
615883	AI抖音 / Douyin Search	douyin_search
32	西瓜视频 / Xigua Video	video_article
568863	抖音精选 / Douyin Select	douyin_select

China Region — iOS/Apple (Douyin / ByteDance)

AID	Display Name	App Name
1128	抖音 / Douyin	aweme
2329	抖音极速版 / Douyin Lite	aweme_lite
1347	像塑 / EffectCam	effectcam
8712	随变 / Douyin Spark	douyin_spark
615883	AI抖音 / Douyin Search	douyin_search
561124	抖音商城 / Douyin eCommerce	douyinecommerce
1349	多闪 / Maya	maya
547599	抖音直播伴侣 / Douyin LivePro	livepro
8663	抖音火山版 / Douyin Hotsoon	aweme_hotsoon
568863	抖音精选 / Douyin Select	douyin_select
8478	汽水音乐 / Luna Music	luna
905678	抖省省 / Douyin Life Services	douyin_life_services

---

Features

Feature	Description
Device Registration	Generate and register real device fingerprints (Android, iOS, Web, Windows)
Email Registration	Create TikTok accounts with email + OTP verification
Mobile Registration	Register accounts via phone number with SMS code support
Fast Mobile Register	High-speed variant of mobile registration
Email Login	Log into existing accounts using email or username + password
Mobile Login	Log in via phone number with verification code
Account Reset	Trigger and verify account password reset flows
Auto Captcha	Automatic captcha solving built into the API
RI Reports	Full pre/post-registration SDK report pipeline
Video Like / Like (Kids)	Like videos on standard and Kids Mode
Video Share / Save	Share and bookmark videos
User Follow	Follow users by ID and sec_uid
Profile Picture	Automatically assign a random profile picture
Find User by Username	Resolve public user details from a username
Douyin / ByteDance Support	Full support for China-region AIDs (Douyin, Xigua, Luna, etc.)
Version Manager	Automatically selects the correct app version per platform
Device Database	Bundled real-device data: Samsung, Xiaomi, Huawei, Nokia, Motorola, iOS, Windows

---

Supported Platforms

• Android — PlatformConfig.ANDROID
• iOS / Apple — PlatformConfig.APPLE
• Web — PlatformConfig.WEB
• Windows — PlatformConfig.WINDOWS

---

Project Structure

tikapis/
├── TikAPIs/
│   └── TikAPIs.py            # Core SDK client
├── Manager/
│   ├── SDKManager.py         # SDK token & seed management
│   ├── VersionManager.py     # App version resolver
│   ├── RIReportManager.py    # RI report pipeline
│   └── PlatformConfig.py     # Platform & AID definitions
├── devices/
│   └── data/                 # Real device fingerprint databases
│       ├── android/          # Samsung, Xiaomi, Huawei, Nokia, Motorola
│       ├── ios/              # iPhone device list
│       ├── windows/          # ASUS, Dell, HP, Lenovo, Microsoft
│       └── web/              # Android, iOS, macOS, Windows, Linux web UAs
├── helpers/
│   ├── Platfrom.py           # App config builder
│   ├── utils.py              # General utilities & mobile data generator
│   ├── account_utils.py      # Account output helpers
│   ├── generators.py         # Data generators
│   ├── SafePrinter.py        # Colored console output
│   ├── CountryCodes.py       # Country / phone prefix data
│   └── FileManager.py        # Thread-safe file I/O
├── config.py                 # Global configuration (set your API_KEY here)
├── tiktok_register.py        # Email registration flow
├── tiktok_mobile_register.py # Mobile registration flow
├── fast_mobile_register.py   # High-speed mobile registration
├── tiktok_login.py           # Login via email or username
├── tiktok_mobile_login.py    # Login via mobile number
├── tiktok_email_signup.py    # Email signup with OTP
├── account_reset.py          # Account password reset flow
└── requirements.txt

---

Quick Start

1. Install dependencies

pip install -r requirements.txt

2. Set your API key

Open config.py and add your key:

API_KEY = "your-api-key-here"   # Get it at https://tikapis.com
API_URL = "https://mobile-api.tikapis.com"

Don't have an API key yet? Visit tikapis.com to get one.

3. Configure your session

# config.py
LANG       = "us"                    # Target country
APP_AID    = 1233                    # TikTok AID (1233 = TikTok global)
PLATFORM   = PlatformConfig.ANDROID  # android / apple / web / windows
SDK_TOKEN  = "all"
GET_SEED   = "all"

4. Run a flow

# Email registration
python tiktok_register.py

# Mobile registration
python tiktok_mobile_register.py

# Login
python tiktok_login.py

# Account reset
python account_reset.py

---

SDK Usage Example

from TikAPIs.TikAPIs import TikAPIs
from Manager.VersionManager import VersionManager
from helpers.Platfrom import app_create

app = app_create("us", "android", argus_mode="register")
app["app_info"] = VersionManager(aid=1233).select("android")

tiktok = TikAPIs(1233, "android", **app)

# Register a device
tiktok.device_register()

# Register a passport account
tiktok.passport_register()

# Like a video
tiktok.video_like("7380000000000000000")

# Follow a user
tiktok.user_follow(user_id="123456", sec_uid="MS4wLj...")

---

API Endpoints (via mobile-api.tikapis.com)

Device

Method	Endpoint	Description
POST	/device_register	Register a device fingerprint
POST	/device/did_cert	Generate / refresh DID certificate

Passport & Auth

Method	Endpoint	Description
POST	/passport/login	Login with email or username
POST	/passport/register	Create a new account
POST	/passport/mobile/send_code	Send SMS verification code
POST	/passport/mobile/check_code	Verify SMS code
POST	/passport/mobile/account_lookup	Look up account by mobile number
POST	/passport/mobile/sms_login_continue	Continue SMS login flow
POST	/passport/email/signup	Start email signup
POST	/passport/email/check_code	Verify email OTP
POST	/passport/account_reset	Trigger password reset
POST	/passport/account_reset_code	Verify reset code
POST	/passport/token/beat	Refresh session token
POST	/passport/im/reboot/misc	Reboot IM session
POST	/passport/region	Query available passport regions
POST	/passport/auto/captcha	Auto-solve captcha

User

Method	Endpoint	Description
POST	/user/self	Get authenticated user's own profile
POST	/user/info	Get account info
POST	/user/profile	Get detailed profile
POST	/user/posts	Get posts for authenticated user
POST	/user/follow/{user_id}/{sec_uid}	Follow a user
POST	/user/unfollow/{user_id}/{sec_uid}	Unfollow a user
POST	/user/followers/{user_id}	Get a user's follower list
POST	/user/followings/{user_id}	Get a user's following list
POST	/user/change-your-profile-picture	Update profile picture
POST	/user/edit-username	Change account username
POST	/user/edit-nickname	Change account display name
POST	/user/edit-biography	Update account bio
POST	/user-detail/{username}	Fetch public user details

Video & Content

Method	Endpoint	Description
POST	/like/{video_id}	Like a video
POST	/like_kids/{video_id}	Like a video (Kids Mode)
POST	/unlike/{video_id}	Unlike a video
POST	/share/{video_id}	Share a video
POST	/save/{video_id}	Save / bookmark a video
POST	/stats/{video_id}	Get video stats
POST	/post/multi_aweme_details	Get details for multiple videos
POST	/share/video	Upload and share a video
POST	/share/photo	Upload and share a photo
POST	/share/story	Upload and share a story

Comments

Method	Endpoint	Description
POST	/comment/publish/{aweme_id}	Publish a comment on a video
POST	/comment/like/{aweme_id}/{comment_id}	Like a comment
POST	/comment/unlike/{aweme_id}/{comment_id}	Unlike a comment
POST	/comment/delete/{comment_id}	Delete a comment

Messaging (DMs)

Method	Endpoint	Description
POST	/message/inbox	Fetch DM inbox
POST	/message/readindex	Get last-read index for conversations
POST	/message/text/send/{user_id}	Send a plain-text DM
POST	/message/video/send/{user_id}	Share a TikTok video in a DM
POST	/message/link/send/{user_id}	Send a web-link card DM
POST	/message/share/send/{user_id}	Share a user profile card in a DM

Notices

Method	Endpoint	Description
POST	/notice/system	Fetch system notice box

MSSDK

Method	Endpoint	Description
POST	/mssdk/ri_report	Send RI SDK report
POST	/mssdk/get_seed	Fetch MSSDK dynamic seed
POST	/mssdk/dyn_report	Send MSSDK dynamic report
POST	/mssdk/get_token	Fetch MSSDK token
POST	/mssdk/common_setting	Fetch MSSDK common settings
POST	/mssdk/dyn_task	Execute MSSDK dynamic task
POST	/mssdk/get_dctoken	Fetch MSSDK DC token
POST	/mssdk/dc_at	MSSDK DC AT request

Captcha

Method	Endpoint	Description
POST	/captcha/solve	Automatically solve a pending captcha

Full API documentation: mobile-api.tikapis.com

---

Requirements

requests
phonenumbers
Faker
pytz
portalocker

Python 3.10+ is required.

---

Important Notes

• A proxy is required for every request. Pass it in your config as proxy_info.
• All output files are saved to devices_txt/ and users_txt/ (auto-created, excluded from git).
• Never commit your API_KEY. Use environment variables in production.

---

Get Your API Key

Visit tikapis.com to register and get your API key. The API is hosted at mobile-api.tikapis.com.

---

License

MIT — free to use, modify, and distribute.

---

Built with the TikAPIs infrastructure. Not affiliated with TikTok or ByteDance.