Skip to content

Thyfwx/TokIntel

 
 

Repository files navigation

TokIntel: free TikTok account lookup

TokIntel: free TikTok account lookup

Python 3.11+ No API key MIT License

Find when a TikTok account was created. No API key, no signup, just a username.


✨ What it does

  • Account creation date from a username, @handle, or profile URL, plus followers, likes, bio, verified, and private status.

    account lookup result

  • Video upload time from a video URL or id (the snowflake timestamp, id >> 32).
  • Optional OSINT pivots (opt in): checks the same handle across YouTube, GitHub, Linktree, Snapchat, SoundCloud, Patreon, Tumblr, and Roblox, and shows only the ones that really exist, as plain text since a shared handle may be a different person. Plus the profile's own bio link, a Google Lens search of its avatar, and a Wayback Machine snapshot when one exists. Platforms that can't be verified without a login are left out instead of guessed, nothing is downloaded, and only the profile's own links open on a click.

    OSINT pivots panel

    OSINT output when no other accounts match the handle

  • Optional integrity flags (opt in): heuristic signals for bought followers, follow farms, rapid growth, and recent handle or display name changes, shown as neutral context rather than accusations.

    integrity flags on a bought-follower account

  • Reports saved to reports/ as JSON and TXT.
  • A clean terminal UI, or a single command. No RapidAPI, no key, no card.

⬇️ Get it

Easiest, no tools needed: click the green < > Code button near the top of this page, choose Download ZIP, then unzip it.

Or with git:

git clone https://github.com/Thyfwx/TokIntel.git
cd TokIntel

The only thing you need installed yourself is Python 3.11 or newer (get it from python.org if you don't have it). Everything else (requests, colorama, rich) is installed for you automatically the first time you run it.

🚀 Run it

Your system How to start
macOS double click TokIntel.app (or TokIntel.command)
Windows double click start.bat
Linux / any terminal run ./start.sh

The launcher builds its own virtual environment and installs requests, colorama, and rich on first run, so there is nothing to set up by hand.

macOS: if you downloaded the ZIP and a double-click is blocked ("unidentified developer"), right-click TokIntel.appOpenOpen once, and it will trust it from then on. Cloning with git avoids this entirely.

Prefer the command line?

python3 tiktok_created.py charlidamelio
python3 tiktok_created.py @nasa https://www.tiktok.com/@zachking

# Optional extras (off by default)
python3 tiktok_created.py charlidamelio --osint    # add pivot links
python3 tiktok_created.py charlidamelio --flags    # add integrity heuristics
python3 tiktok_created.py charlidamelio --all      # both

In the interactive UI, a short numbered menu appears after each card so you can pull the extras up only when you want them.

🔍 How it works

TikTok embeds the account createTime in the JSON on every public profile page, so one request to the profile is enough to read it. Video IDs are snowflakes, so a video's upload time comes from id >> 32. No login and no third party API for public accounts, which is almost all of them.

🔒 Accounts with audience controls on (optional)

A few accounts turn on TikTok's audience controls, for example the "18 and older" setting. TikTok then refuses to show that profile to anyone who is not signed in, so a normal lookup gets no date or stats back. That is the account owner's setting, not a limit of this tool, and most accounts have it off and need nothing.

a locked account before unlocking

You can still read these with your own TikTok login, and there is nothing to install or paste. Just look the account up in the app. When it is locked, it asks:

read it with  chrome / firefox / edge / brave / safari

Pick the browser you are already signed into TikTok on, and it reads the account with that login. If you are not signed in, it just tells you to sign in and try again, no errors and no dead ends.

Your privacy, plainly: the login is read only on your own computer, only for that one lookup. It is never saved, never sent anywhere, never shown, and never part of this code, so a clone or a fork has nothing of yours in it. Your account stays yours, and everyone uses their own login, or none at all.

Prefer the command line? Set TIKTOK_COOKIES_FROM_BROWSER=chrome (or firefox, edge, brave, safari) before running, or drop your sessionid value into a gitignored tiktok_session.txt.

📦 Requirements

Python 3.11+ and requests, colorama, rich (installed automatically by the launcher, or pip install -r requirements.txt).

🙌 Credit

Built on top of TokIntel by Victor Bancayan (Hack Underway). The original does more, including email and phone lookups through RapidAPI. This build is a free option that needs no key, for looking up creation dates. Licensed under MIT, see LICENSE.

⚠️ Disclaimer

For educational and OSINT research only. It reads public profile data. Do not use it for anything illegal.

About

Find when a TikTok account was created. No API key, no signup, just a username. Free terminal tool built on TokIntel.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 94.5%
  • Shell 4.2%
  • Batchfile 1.3%