README

TikTok Private API

Installation via Composer

composer require idammi/tiktok-api

Usage

/////////// API  //////////
$debug = false;
$accessKey = 'YOUR_ACCESS_KEY';
$proxy = 'http://user:pass@proxy:port';
///////////////////////////
$tiktok = new \TikTokAPI\TikTok($debug);
$tiktok->setAccessKey($accessKey);
$tiktok->setProxy($proxy);

Available methods

• login - Login user/resume logged in session login($username, $password)
• getComments - Get comments on a post getComments($awemeId, $cursor)
• getUserFeed - Get user posts getUserFeed($secUserId, $cursor)
• getUserFollowers - Get user followers getUserFollowers($secUserId, $max_time)
• getUserFollowing - Get user following getUserFollowing($secUserId, $max_time)
• getChallenge - Get challenge feed getChallenge($ch_id, $cursor)
• getMusic - Get Music feed getMusic($music_id, $cursor)
• getUserInfo - Get user info getUserInfo($secUserId)
• search - General search search($keyword)

Example Login Response

{
    "data": {
        "app_id": 1233,
        "avatar_url": "",
        "connects": [],
        "country_code": 234,
        "device_id": 0,
        "email": "",
        "has_password": 1,
        "is_kids_mode": 0,
        "mobile": "+234****3724",
        "name": "user5180781450262",
        "screen_name": "user5180781450262",
        "sec_user_id": "MS4wLjABAAAAdsnqxZXSEeRzp4ppOc8Zndo14IaYeNxiABwTPfbGkxYCWr4OCzQF90JgJPC33jD6",
        "session_key": "7f6f103535941dc2054baa0446a5cf3a",
        "user_id": 7058506727294240000,
        "user_id_str": "7058506727294239749",
        "user_verified": false
    },
    "message": "success",
    "status": "ok",
    "timestamp": 1657486200
}

API Access Key Usage

You can use Authorization: Bearer <access_key> in the request header or use ?key=<access_key> in the request parameter.

Private API backend functionalities

• Device registration for registering device_id, install_id also known as iid and did.

  • Proper trace-id header generation.
  • Proper X-Gorgon and X-Khronos header generation.
  • Proper TTEncrypting of data (v05).
  • Proper XLoging of registered device_id (v02).

• Account Login

  • Complete device registration when logging in for the first time.
  • Account Login with username/password.
  • Automated captcha solver.

How does this work?

Monthly subscription of my private API service is required for this to function.

Subscription service pricing

• These quota counts on successful responses (with status code 200).

Terms and conditions

• You will NOT use this API for marketing purposes (spam, botting, harassment, massive bulk messaging...).
• We do NOT give support to anyone who wants to use this API to send spam or commit other crimes.
• We reserve the right to block any user of this repository that does not meet these conditions.

Legal

This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by TikTok or any of its affiliates or subsidiaries. This is an independent and unofficial API. Use at your own risk.

Disclaimer

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

If you want, you can reach me on Telegram: https://t.me/dologbonjaye