TikTok User Lookup

TikTok User Lookup is a tiktok user lookup that turns usernames, @handles, or profile URLs into 40-field public account records. Use it when you already have the accounts and need identity, audience totals, account type, and the profile's own permission codes without supplying a TikTok login.

Why Choose TikTok User Lookup

• Unrounded audience totals. Follower, like, video, and mutual counts come from the account's precise statistics block, so a 996,428-follower account reports 996,428 rather than 996,400 — and accounts past 2.1 billion likes report a positive number instead of a negative one.
• Account type, not just size. Organization, commerce, and seller flags plus the declared business category separate a brand account from a creator before you spend outreach on either.
• The profile's own permission codes. Comment, duet, stitch, download, embed, and following-visibility settings answer whether a creator can be collaborated with at all, which no follower count tells you.
• One row per account, one charge per row. Handles that do not resolve are reported and not billed.
• No login, no cookies. Public profile data only, from a single request per account.

Quick Start Guide

Configure

Paste TikTok usernames, @handles, or profile URLs into 🎵 TikTok URL. The field is prefilled with a working example, so pressing Start unmodified returns real rows.

Run

Press ▷ Start. Accounts are looked up one at a time, and each row is saved as it resolves rather than at the end.

Collect

Open the Dataset tab. Export as JSON, CSV, Excel, or XML, or read it through the API using the examples below.

Input Parameters

One input, because a lookup asks one question: which accounts.

Parameter	Type	Required	Description	Example
tiktok_url	array of strings	Yes	TikTok usernames, @handles, or profile URLs. Duplicates are looked up once; unreadable entries are skipped with a count.	["nasa", "@duolingo", "https://www.tiktok.com/@khaby.lame"]

{
  "tiktok_url": ["nasa", "@duolingo", "https://www.tiktok.com/@khaby.lame"]
}

All three input forms resolve to the same account, so a mixed list needs no cleaning first:

Input form	Resolves to
nasa	nasa
@duolingo	duolingo
https://www.tiktok.com/@khaby.lame	khaby.lame

Output Data Schema

Each Dataset item is one resolved TikTok account with 40 top-level fields.

Group	Fields
Identity	user_id, sec_uid, username, nickname, profile_url
Profile	bio, bio_link, link_risk, avatar, language
Timestamps	created_at, nickname_changed_at
Audience	followers, following, likes, likes_given, videos, friends
Account type	verified, is_organization, is_private, is_secret, is_seller, is_commerce, commerce_category, commerce_ios, commerce_android
Permissions	comment_setting, duet_setting, stitch_setting, download_setting, following_visibility, embed_permission, favorites_open, story_status
Profile tabs	tab_music, tab_question, tab_playlist
Provenance	processor, processed_at

sec_uid is the identifier that survives a username change, so it is the one to join on across runs. The permission fields carry the source's own integer codes rather than a translated yes/no, because the published payload states the code without stating which value is permissive.

Values the source does not publish stay empty rather than being guessed. Sparse fields are normal: is_private was set on 3 of 72 sampled accounts and comment_setting on 1 — they identify exactly the accounts a filter is looking for.

Abbreviated illustrative item; a real row contains all 40 fields:

{
  "user_id": "6666753356952683526",
  "sec_uid": "MS4wLjABAAAAU9BRVzC8oCaegVnia8IbqWhPb_-dbU7s00Y3wS1_Nx8g5RUaYvyX",
  "username": "nasa",
  "nickname": "NASA",
  "profile_url": "https://www.tiktok.com/@nasa",
  "bio": "Exploring the universe and our home planet.",
  "followers": 997864,
  "following": 22,
  "likes": 4692537,
  "videos": 29,
  "verified": true,
  "is_organization": true,
  "is_commerce": false,
  "download_setting": 0,
  "tab_playlist": true,
  "processor": "https://apify.com/agentx/tiktok-user-lookup",
  "processed_at": "2026-08-18T00:00:00+00:00"
}

Export formats: JSON, JSONL, CSV, Excel, XML, and RSS through the Dataset API.

Integration Examples

TikTok User Lookup runs from the Apify API, the client libraries, or any MCP client.

Actor ID

SpPvgFhv7JPqUK1nC

The name form agentx~tiktok-user-lookup works anywhere the ID does.

HTTP

curl -X POST "https://api.apify.com/v2/acts/SpPvgFhv7JPqUK1nC/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tiktok_url":["nasa","@duolingo"]}'

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("SpPvgFhv7JPqUK1nC").call(
    run_input={"tiktok_url": ["nasa", "@duolingo"]}
)
for account in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(account["username"], account["followers"])

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('SpPvgFhv7JPqUK1nC').call({
    tiktok_url: ['nasa', '@duolingo'],
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Make.com — add the Apify module, choose Run an Actor, paste SpPvgFhv7JPqUK1nC, and map tiktok_url to your list.

n8n — use the Apify node, paste SpPvgFhv7JPqUK1nC as the Actor, and pass the same JSON input.

MCP — point any MCP client at https://mcp.apify.com and call agentx/tiktok-user-lookup.

Pricing

You pay for accounts that resolve, plus one Actor Start per run.

Event	FREE	Bronze	Silver	Gold and above
Result (one account row)	$0.00250	$0.00225	$0.00200	$0.00188
Actor Start	$0.01	$0.01	$0.01	$0.01

Actor Start is charged once per run, one event per gigabyte of memory with a minimum of one. This Actor runs at 128 MB, so it is always a single Actor Start event.

Smallest run: one account = $0.01 Actor Start + $0.00250 = $0.01250 on the FREE tier.

Typical run: 200 accounts in one run = $0.01 + 200 × $0.00250 = $0.51.

Batching is cheaper because Actor Start is per run, not per account: 200 accounts in one run costs $0.51, while 200 single-account runs cost $2.50. Prices can change — check the pricing page.

Use Cases

• Influencer shortlisting. Filter a candidate list on followers, videos, and verified, then drop the accounts whose duet_setting or stitch_setting rules out the collaboration format you planned.
• Brand-versus-creator triage. Split an outreach list using is_organization, is_commerce, and commerce_category before anyone writes a first message.
• Commerce partner discovery. Find accounts where is_seller is set and commerce_ios or commerce_android points at a real app listing.
• Audience auditing over time. Re-run on a schedule and compare followers, likes, and videos per sec_uid, which survives a username change that would break a handle-keyed join.
• Account hygiene checks. Catch handles that went is_private, or whose nickname_changed_at moved since your last export.

Alternatives

Checking profiles by hand works for five accounts and stops at fifty: the counts shown on a profile page are rounded, and nothing on screen exposes the permission codes at all.

TikTok's own Research API is the authoritative source and is better when you qualify for it — it is available to approved academic and non-profit researchers, requires an application, and covers far more than profiles.

Social listening suites bundle profile lookups into a monthly subscription with dashboards. Choose those when the reporting layer is what you are buying.

Choose something else if you need a follower or following list (this Actor returns the counts, not the names), private-account contents, video-level data (use TikTok Creator API), or anything requiring a signed-in session.

Limits and Troubleshooting

• A handle returns no row → the account does not exist, was renamed, or was removed → check the handle on the web; renamed accounts keep their sec_uid, so an earlier export can resolve them.
• likes_given is empty → most accounts do not publish it; it appeared on 2 of 72 sampled accounts → treat it as a bonus field, not a filter.
• Permission fields are empty → the account left them at the source's default → absence means unset, not restricted.
• Every account fails at once → the source is refusing the exit → re-run; each account tries the direct path first and then up to 30 public exits.
• Counts differ slightly from the profile page → the page rounds and this Actor does not → the Dataset value is the precise one.

Report problems on the Issues tab with the run ID, the input list, and the handle that behaved unexpectedly.

Trust and Reliability

Runs on Apify's platform with per-run logs and a documented 40-field Dataset contract that stays stable across runs. Billing is per resolved account: handles that return nothing are not charged. Every value is copied or deterministically normalized from the account's own public profile payload — nothing is inferred, estimated, or filled in from another account.

Legal and Compliance

Data scope. Public profile data only. No login, no cookies, and no access to private accounts, direct messages, or anything behind a follow request.

Privacy. Profile fields can identify individuals. If you process rows about people in the EU or UK, you need your own lawful basis under the GDPR, and you remain the controller of what you store.

Platform terms. Automated collection may conflict with TikTok's Terms of Service. Review them and your own obligations before running at scale.

Frequently Asked Questions

Is there a free TikTok user lookup API?

No free API returns this data reliably. Free web tools handle one account at a time and show rounded counts; TikTok's own Research API is free but requires an approved academic or non-profit application. This Actor charges $0.00250 per resolved account with no subscription.

Can I use this for a TikTok user lookup without login?

Yes. Every request is anonymous — no account, no cookies, no session token. That is also the boundary: anything TikTok shows only to signed-in viewers, including follower lists, is out of reach by design.

Can I do a bulk TikTok profile lookup by username?

Yes. Pass any number of usernames, @handles, or profile URLs in one run. Duplicates are looked up once and each resolved account is charged once, so batching lowers cost per account by amortising the single Actor Start.

Does it return followers and following lists?

No. It returns the follower and following counts, not the names. TikTok does not serve relationship lists to anonymous callers: six endpoints were measured on 2026-08-18 and none returned a target account's list.

Why do the numbers differ from what the profile page shows?

The page rounds — 997.8k where the account has 996,428 — and its raw counter overflows past 2.1 billion, turning large like totals negative. This Actor reads the precise statistics block instead.

Can I schedule runs to monitor TikTok accounts over time?

Yes. Use Apify Schedules and join successive Datasets on sec_uid, which survives a username change. Comparing followers, likes, and videos across runs gives a growth series.

What happens to handles that do not exist?

They are reported in the log and skipped. No row is created and no Result event is charged.

Does it work on private accounts?

A private account still returns its public profile row, with is_private set. Its content is not available.

Related AgentX Actors

AgentX currently publishes 79 Actors; start with the three closest TikTok and cross-platform profile tools, then browse the complete catalog by category.

Closest to this Actor:

• TikTok Creator API — collect the videos behind an account once a lookup has shortlisted it.
• Instagram Creator Scraper — the same lookup shape for Instagram, to put one creator's two profiles side by side.
• TikTok Transcript — read what a shortlisted account actually says in its videos.

Business and Market Intelligence

• Google Keyword Trends — Google Trends keyword interest, compared five at a time
• Google Trends Scraper — Google Trends trending searches
• Google Maps Store Scraper — Google Maps business listings
• LinkedIn Company Lookup — LinkedIn company records
• LinkedIn Profile Lookup — LinkedIn profile records
• Weather Forecast API — forecast and historical weather data

Jobs and Hiring

• All Jobs Scraper — multi-platform job listings
• Bayt Jobs Scraper — Bayt job listings
• Glassdoor Jobs Scraper — Glassdoor job listings
• Indeed Jobs Scraper — Indeed job listings
• JobStreet Company Profile — JobStreet employer records
• Jooble Jobs Scraper — Jooble job listings
• LinkedIn Jobs Scraper — LinkedIn job listings
• Naukri Jobs Scraper — Naukri job listings
• Talent Jobs Scraper — Talent.com job listings
• ZipRecruiter Jobs Scraper — ZipRecruiter job listings

Social Media

• Instagram Creator Scraper — Instagram creator profiles
• Instagram Reels Scraper — Instagram Reels metadata
• Instagram Trending Scraper — Instagram trending content
• Medium Scraper — Medium articles
• Medium Profile Scraper — Medium author profiles
• Reddit Profile Scraper — Reddit user profiles
• Reddit Viral Scraper — Reddit viral posts
• SubReddit Info Scraper — subreddit metadata
• Subreddit Members Scraper — subreddit member lists
• Subreddit Posts Scraper — subreddit post feeds
• Telegram Chat Scraper — Telegram chat messages
• Telegram Info Scraper — Telegram channel metadata
• Telegram Member Adder — Telegram group membership management
• Telegram Member Scraper — Telegram group members
• Telegram Private Group Scraper — private Telegram group data
• TikTok Creator API — TikTok creator profiles
• X Twitter Community API — X community data
• X Twitter Profile Lookup — X profile records
• YouTube Creator Email Scraper — YouTube creator contact data

Video, Transcripts and Downloads

• All Video Scraper — multi-platform video metadata
• Video Transcript — multi-platform transcripts
• Video Captions Downloader — caption files
• Video to Social Post — video repurposed into social copy
• YouTube Transcript — YouTube transcripts
• TikTok Transcript — TikTok transcripts
• X Twitter Transcript — X video transcripts
• Facebook Transcript — Facebook video transcripts
• Bilibili Transcript — Bilibili transcripts
• Dailymotion Transcript — Dailymotion transcripts
• Rutube Transcript — Rutube transcripts
• Loom Transcript — Loom transcripts
• Wistia Transcript — Wistia transcripts
• Instagram Reels Downloader — Reels downloads
• Kick Clip Downloader — Kick clip downloads
• Linkedin Video Downloader — LinkedIn video downloads
• Pinterest Video Downloader — Pinterest video downloads
• Reddit Video Downloader — Reddit video downloads
• Snapchat Video Downloader — Snapchat video downloads
• TED Talk Downloader — TED talk downloads
• TikTok Live Downloader — TikTok live downloads
• Twitch VOD Downloader — Twitch VOD downloads
• Zoom Recording Downloader — Zoom recording downloads

E-Commerce and Retail

• All Shopping Scraper — multi-platform product data
• AliExpress Product Scraper — AliExpress products
• Amazon Storefront Scraper — Amazon Brand Store pages
• Bol Product Scraper — Bol.com products
• eBay Seller Leads API — eBay seller records
• Hepsiburada Product Scraper — Hepsiburada products
• Kakaku Product Scraper — Kakaku.com products
• Rakuten Product Scraper — Rakuten products

Classifieds and Automotive

• All Vehicle Scraper — multi-platform vehicle listings
• AutoTrader Vehicle Search — AutoTrader US listings
• AutoTrader UK Vehicle Search — AutoTrader UK listings

Real Estate

• All Property Scraper — multi-platform property listings
• Homes Property Scraper — Homes.com listings
• MagicBricks Property Scraper — MagicBricks listings
• NoBroker Property Scraper — NoBroker listings
• Property24 Property Scraper — Property24 listings
• Realtor Property Scraper — Realtor.com listings
• Zillow Property Scraper — Zillow listings

Support and Community

Open an issue on the Issues tab for bugs and field requests. Browse the rest of the catalogue at apify.com/agentx.

AgentX is an Arcyton brand — arcyton.com.

Last Updated: August 18, 2026