# TikTok User Lookup (`agentx/tiktok-user-lookup`) Actor

TikTok user lookup returns 40-field public account records for any list of usernames, @handles, or profile URLs, with unrounded follower and like totals, account type, commerce status, and the profile's own permission codes—no login; from $0.00250/account.

- **URL**: https://apify.com/agentx/tiktok-user-lookup.md
- **Developed by:** [AgentX](https://apify.com/agentx) (community)
- **Categories:** Social media, Lead generation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.88 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

**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.

[![Apify Users](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.apify.com%2Fv2%2Facts%2Fagentx~tiktok-user-lookup\&query=%24.data.stats.totalUsers\&style=for-the-badge\&label=Apify%20Users\&color=ff9013)](https://apify.com/agentx/tiktok-user-lookup) [![Apify Runs](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.apify.com%2Fv2%2Facts%2Fagentx~tiktok-user-lookup\&query=%24.data.stats.totalRuns\&style=for-the-badge\&label=Apify%20Runs\&color=ff9013)](https://apify.com/agentx/tiktok-user-lookup) [![$0.00250 per account](https://img.shields.io/badge/%240.00250%20%2F%20account-4285f4?style=for-the-badge)](https://apify.com/agentx/tiktok-user-lookup/pricing) [![40 fields](https://img.shields.io/badge/40%20fields-34a853?style=for-the-badge)](https://console.apify.com/actors/SpPvgFhv7JPqUK1nC/input) [![API + MCP ready](https://img.shields.io/badge/API%20%2B%20MCP%20ready-fbbc05?style=for-the-badge)](https://apify.com/agentx/tiktok-user-lookup/api)

### 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"]` |

```json
{
  "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:

```json
{
  "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

```text
SpPvgFhv7JPqUK1nC
```

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

**HTTP**

```bash
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**

```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**

```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](https://apify.com/agentx/tiktok-user-lookup/pricing).

### 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](https://console.apify.com/actors/SpPvgFhv7JPqUK1nC/issues) 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](https://apify.com/agentx/tiktok-creator-api) — collect the videos behind an account once a lookup has shortlisted it.
- [Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper) — the same lookup shape for Instagram, to put one creator's two profiles side by side.
- [TikTok Transcript](https://apify.com/agentx/tiktok-transcript) — read what a shortlisted account actually says in its videos.

#### Business and Market Intelligence

- **[Google Keyword Trends](https://apify.com/agentx/google-keyword-trends)** — Google Trends keyword interest, compared five at a time
- **[Google Trends Scraper](https://apify.com/agentx/google-trends-scraper)** — Google Trends trending searches
- **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper)** — Google Maps business listings
- **[LinkedIn Company Lookup](https://apify.com/agentx/linkedin-company-lookup)** — LinkedIn company records
- **[LinkedIn Profile Lookup](https://apify.com/agentx/linkedin-profile-lookup)** — LinkedIn profile records
- **[Weather Forecast API](https://apify.com/agentx/weather-forecast-api)** — forecast and historical weather data

#### Jobs and Hiring

- **[All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper)** — multi-platform job listings
- **[Bayt Jobs Scraper](https://apify.com/agentx/bayt-jobs-scraper)** — Bayt job listings
- **[Glassdoor Jobs Scraper](https://apify.com/agentx/glassdoor-jobs-scraper)** — Glassdoor job listings
- **[Indeed Jobs Scraper](https://apify.com/agentx/indeed-jobs-scraper)** — Indeed job listings
- **[JobStreet Company Profile](https://apify.com/agentx/jobstreet-company-profile)** — JobStreet employer records
- **[Jooble Jobs Scraper](https://apify.com/agentx/jooble-jobs-scraper)** — Jooble job listings
- **[LinkedIn Jobs Scraper](https://apify.com/agentx/linkedin-jobs-scraper)** — LinkedIn job listings
- **[Naukri Jobs Scraper](https://apify.com/agentx/naukri-jobs-scraper)** — Naukri job listings
- **[Talent Jobs Scraper](https://apify.com/agentx/talent-jobs-scraper)** — Talent.com job listings
- **[ZipRecruiter Jobs Scraper](https://apify.com/agentx/ziprecruiter-jobs-scraper)** — ZipRecruiter job listings

#### Social Media

- **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper)** — Instagram creator profiles
- **[Instagram Reels Scraper](https://apify.com/agentx/instagram-reels-scraper)** — Instagram Reels metadata
- **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper)** — Instagram trending content
- **[Medium Scraper](https://apify.com/agentx/medium-scraper)** — Medium articles
- **[Medium Profile Scraper](https://apify.com/agentx/medium-profile-scraper)** — Medium author profiles
- **[Reddit Profile Scraper](https://apify.com/agentx/reddit-profile-scraper)** — Reddit user profiles
- **[Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper)** — Reddit viral posts
- **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper)** — subreddit metadata
- **[Subreddit Members Scraper](https://apify.com/agentx/subreddit-members-scraper)** — subreddit member lists
- **[Subreddit Posts Scraper](https://apify.com/agentx/subreddit-posts-scraper)** — subreddit post feeds
- **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper)** — Telegram chat messages
- **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper)** — Telegram channel metadata
- **[Telegram Member Adder](https://apify.com/agentx/telegram-member-adder)** — Telegram group membership management
- **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper)** — Telegram group members
- **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper)** — private Telegram group data
- **[TikTok Creator API](https://apify.com/agentx/tiktok-creator-api)** — TikTok creator profiles
- **[X Twitter Community API](https://apify.com/agentx/x-twitter-community-api)** — X community data
- **[X Twitter Profile Lookup](https://apify.com/agentx/x-twitter-profile-lookup)** — X profile records
- **[YouTube Creator Email Scraper](https://apify.com/agentx/youtube-creator-email-scraper)** — YouTube creator contact data

#### Video, Transcripts and Downloads

- **[All Video Scraper](https://apify.com/agentx/all-video-scraper)** — multi-platform video metadata
- **[Video Transcript](https://apify.com/agentx/video-transcript)** — multi-platform transcripts
- **[Video Captions Downloader](https://apify.com/agentx/video-captions-downloader)** — caption files
- **[Video to Social Post](https://apify.com/agentx/video-to-social-post)** — video repurposed into social copy
- **[YouTube Transcript](https://apify.com/agentx/youtube-transcript)** — YouTube transcripts
- **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript)** — TikTok transcripts
- **[X Twitter Transcript](https://apify.com/agentx/x-twitter-transcript)** — X video transcripts
- **[Facebook Transcript](https://apify.com/agentx/facebook-transcript)** — Facebook video transcripts
- **[Bilibili Transcript](https://apify.com/agentx/bilibili-transcript)** — Bilibili transcripts
- **[Dailymotion Transcript](https://apify.com/agentx/dailymotion-transcript)** — Dailymotion transcripts
- **[Rutube Transcript](https://apify.com/agentx/rutube-transcript)** — Rutube transcripts
- **[Loom Transcript](https://apify.com/agentx/loom-transcript)** — Loom transcripts
- **[Wistia Transcript](https://apify.com/agentx/wistia-transcript)** — Wistia transcripts
- **[Instagram Reels Downloader](https://apify.com/agentx/instagram-reels-downloader)** — Reels downloads
- **[Kick Clip Downloader](https://apify.com/agentx/kick-clip-downloader)** — Kick clip downloads
- **[Linkedin Video Downloader](https://apify.com/agentx/linkedin-video-downloader)** — LinkedIn video downloads
- **[Pinterest Video Downloader](https://apify.com/agentx/pinterest-video-downloader)** — Pinterest video downloads
- **[Reddit Video Downloader](https://apify.com/agentx/reddit-video-downloader)** — Reddit video downloads
- **[Snapchat Video Downloader](https://apify.com/agentx/snapchat-video-downloader)** — Snapchat video downloads
- **[TED Talk Downloader](https://apify.com/agentx/ted-talk-downloader)** — TED talk downloads
- **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader)** — TikTok live downloads
- **[Twitch VOD Downloader](https://apify.com/agentx/twitch-vod-downloader)** — Twitch VOD downloads
- **[Zoom Recording Downloader](https://apify.com/agentx/zoom-recording-downloader)** — Zoom recording downloads

#### E-Commerce and Retail

- **[All Shopping Scraper](https://apify.com/agentx/all-shopping-scraper)** — multi-platform product data
- **[AliExpress Product Scraper](https://apify.com/agentx/aliexpress-product-scraper)** — AliExpress products
- **[Amazon Storefront Scraper](https://apify.com/agentx/amazon-storefront-scraper)** — Amazon Brand Store pages
- **[Bol Product Scraper](https://apify.com/agentx/bol-product-scraper)** — Bol.com products
- **[eBay Seller Leads API](https://apify.com/agentx/ebay-seller-leads-api)** — eBay seller records
- **[Hepsiburada Product Scraper](https://apify.com/agentx/hepsiburada-product-scraper)** — Hepsiburada products
- **[Kakaku Product Scraper](https://apify.com/agentx/kakaku-product-scraper)** — Kakaku.com products
- **[Rakuten Product Scraper](https://apify.com/agentx/rakuten-product-scraper)** — Rakuten products

#### Classifieds and Automotive

- **[All Vehicle Scraper](https://apify.com/agentx/all-vehicle-scraper)** — multi-platform vehicle listings
- **[AutoTrader Vehicle Search](https://apify.com/agentx/autotrader-vehicle-search)** — AutoTrader US listings
- **[AutoTrader UK Vehicle Search](https://apify.com/agentx/autotrader-uk-vehicle-search)** — AutoTrader UK listings

#### Real Estate

- **[All Property Scraper](https://apify.com/agentx/all-property-scraper)** — multi-platform property listings
- **[Homes Property Scraper](https://apify.com/agentx/homes-property-scraper)** — Homes.com listings
- **[MagicBricks Property Scraper](https://apify.com/agentx/magicbricks-property-scraper)** — MagicBricks listings
- **[NoBroker Property Scraper](https://apify.com/agentx/nobroker-property-scraper)** — NoBroker listings
- **[Property24 Property Scraper](https://apify.com/agentx/property24-property-scraper)** — Property24 listings
- **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper)** — Realtor.com listings
- **[Zillow Property Scraper](https://apify.com/agentx/zillow-property-scraper)** — Zillow listings

### Support and Community

Open an issue on the [Issues tab](https://console.apify.com/actors/SpPvgFhv7JPqUK1nC/issues) for bugs and field requests. Browse the rest of the catalogue at [apify.com/agentx](https://apify.com/agentx).

AgentX is an Arcyton brand — [arcyton.com](https://arcyton.com).

**Last Updated:** August 18, 2026

# Actor input Schema

## `tiktok_url` (type: `array`):

TikTok usernames, @handles, or profile URLs to look up. Each resolved account returns one row; unresolvable handles are reported and not charged.

## Actor input object example

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

# Actor output Schema

## `results` (type: `string`):

Table view led by avatar, username, nickname and profile URL, then audience counts, account type and commerce fields, permission codes, profile tabs, and provenance.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "tiktok_url": [
        "nasa",
        "@duolingo",
        "https://www.tiktok.com/@khaby.lame"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("agentx/tiktok-user-lookup").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "tiktok_url": [
        "nasa",
        "@duolingo",
        "https://www.tiktok.com/@khaby.lame",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("agentx/tiktok-user-lookup").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "tiktok_url": [
    "nasa",
    "@duolingo",
    "https://www.tiktok.com/@khaby.lame"
  ]
}' |
apify call agentx/tiktok-user-lookup --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,agentx/tiktok-user-lookup"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/SpPvgFhv7JPqUK1nC/builds/BiGj6gd5oFaFkxMJ7/openapi.json