TikTok Profile Intelligence

Analyze public TikTok creators with structured profile data, recent post metrics, and calculated engagement rates. TikTok Profile Intelligence helps influencer marketing teams, creator researchers, lead-generation teams, agencies, and developers turn public TikTok profiles into clean, automation-ready datasets.

Enter a TikTok username, @handle, or profile URL. Export the results as JSON, CSV, Excel, XML, or RSS, or connect them to the Apify API, webhooks, schedules, Make, n8n, Zapier, Google Sheets, Python, and other workflows.

Unofficial Actor: This independent project is not affiliated with, endorsed by, or sponsored by TikTok. Use it only for public data you have a lawful reason to process, and follow applicable laws, TikTok's terms, and Apify's policies.

What can this TikTok profile scraper do?

• Extract public TikTok profile statistics and recent posts.
• Accept usernames, @handles, and complete profile URLs.
• Return clean profile, post, and error records with a stable schema.
• Distinguish video posts from photo (image carousel) posts.
• Calculate post engagement rate automatically.
• Sort collected posts by latest publication date or view count.
• Retry blocked or incomplete profiles using fresh proxy sessions.
• Prevent blocked metadata from being reported as genuine zero values.
• Return every post it recovers, flagged with isPartial, when TikTok exposes fewer than requested.
• Continue processing when one profile fails instead of failing the whole run.
• Produce compact exports while keeping optional raw source data available for debugging.
• Support recurring monitoring through Apify schedules, API calls, webhooks, and integrations.

Who is this Actor for?

• Influencer marketing: review creator size, activity, and post engagement.
• Creator discovery and qualification: compare public creators already on your shortlist.
• Campaign reporting: collect repeatable snapshots of public profile and post performance.
• Lead generation: enrich known TikTok handles with public creator metrics.
• Competitive research: monitor public brand or competitor accounts over time.
• Automation builders: send structured TikTok data to CRMs, spreadsheets, databases, and AI workflows.

This Actor analyzes profiles you provide. It does not discover creators by keyword, download media, scrape comments, or access private profiles.

Quick start

1. Add one or more public TikTok usernames, @handles, or profile URLs.
2. Choose the maximum number of recent posts per profile.
3. Keep Automatic Apify Proxy selected for the normal cost-efficient setup.
4. Click Start.
5. Open the default dataset and export or integrate the results.

Example input:

{
  "profiles": ["duolingo", "@apifytech"],
  "resultsPerProfile": 3,
  "sort": "latest",
  "includeRawData": false,
  "maxRetries": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Start with 1 profile and 3 posts while testing. You can then scale up to 25 profiles and 100 posts per profile.

What TikTok data can you extract?

Profile results

• Username and profile URL
• Display name and biography
• Verification status
• Followers and following
• Total profile likes
• Published video count
• Requested and returned post counts
• Partial-result status

Post results

• Post ID and canonical post URL (postUrl)
• Media type (contentType: video or photo)
• Video URL for video posts (videoUrl, null for photo posts)
• Caption and publication time
• Views and likes
• Comments and shares
• Saves, when TikTok exposes them
• Pinned status
• Calculated engagement rate

Error results

• Stable error code
• Human-readable error message
• Number of attempts
• Retry guidance

An EXTRACTION_FAILED result means TikTok returned blocked or inconsistent public metadata after all configured retries. The Actor reports the problem explicitly instead of returning misleading zero-valued profile statistics.

Photo posts

TikTok profiles mix video posts and photo (image carousel) posts. Both are returned. Check contentType to tell them apart:

• contentType: "video" — videoUrl and postUrl both point at the post.
• contentType: "photo" — postUrl points at the /photo/ URL and videoUrl is null, because a photo post has no video.

Partial results

TikTok does not always expose as many posts as you request; long feeds are throttled and some items are hidden. When the Actor resolves a profile and recovers at least one genuine post but fewer than resultsPerProfile, it keeps everything it found and marks the profile row:

• requestedPosts — how many you asked for
• postsReturned — how many were actually recovered
• isPartial: true — fewer posts were available than requested

A partial result is a normal successful result: the recovered profile and posts are written to the dataset and no error row is produced. Missing posts are never fabricated. Genuine failures — an unresolvable profile, blocked extraction, or untrustworthy metadata — still produce an error record instead.

Built-in TikTok engagement analytics

TikTok Profile Intelligence adds a calculated engagement rate to each post when views are available:

engagementRate = (likes + comments + shares) / views × 100

For example, a post with 725 likes, 10 comments, 30 shares, and 83,900 views has an engagement rate of approximately 0.9118%. This view-based rate helps compare the response generated by collected posts, but it should not be treated as a complete measure of creator quality or campaign performance.

Output example

{
  "recordType": "post",
  "username": "apifytech",
  "videoId": "7353646097262202145",
  "videoUrl": "https://www.tiktok.com/@apifytech/video/7353646097262202145",
  "postUrl": "https://www.tiktok.com/@apifytech/video/7353646097262202145",
  "contentType": "video",
  "caption": "Example post",
  "createdAt": "2024-04-03T14:22:40+00:00",
  "views": 83900,
  "likes": 725,
  "comments": 10,
  "shares": 30,
  "saves": 135,
  "engagementRate": 0.9118,
  "isPinned": true
}

The Actor normally writes one profile result followed by its post results. Use recordType to separate profile, post, and error rows in exports or integrations.

TikTok Profile Intelligence pricing

This Actor uses pay-per-event pricing with platform usage included. The result price depends on the user's Apify plan:

Apify plan	Price per 1,000 results	Price per result
Free	$2.50	$0.0025
Starter	$2.25	$0.00225
Scale	$2.125	$0.002125
Business	$2.00	$0.002

Every run also has a $0.002 Actor start charge. There is no separate Apify platform-usage charge for users.

A billable result is each item written to the Actor's default dataset:

• One successful profile row = 1 result
• Each returned post row = 1 result
• One structured error row = 1 result

Examples at the Free-plan price (paid plans receive the discounts above):

Run output	Billable results	Result charge	Start charge	Total charge
1 profile, no posts	1	$0.0025	$0.002	$0.0045
1 profile + 3 posts (default)	4	$0.010	$0.002	$0.012
1 profile + 20 posts	21	$0.0525	$0.002	$0.0545
10 profiles + 20 posts each	Up to 210	Up to $0.525	$0.002	Up to $0.527

Actual output can be lower when TikTok exposes fewer posts than requested — a partial result is billed only for the records actually delivered, and produces no extra error row. Retries do not themselves create extra result-event charges; a final error item is one dataset result. Set resultsPerProfile to 0 when you need only profile summaries, and start with a small run before scaling.

Use the results in your workflow

After a run, download the default dataset in JSON, CSV, Excel, XML, or RSS format. You can also:

• Call the Actor and retrieve its dataset through the Apify API.
• Run it automatically with Apify schedules.
• trigger Make, n8n, Zapier, or custom webhooks when a run finishes.
• Send qualified creators to Google Sheets, Airtable, a CRM, or a database.
• Feed normalized creator and engagement data into an AI classification workflow.

Example workflow:

TikTok profiles → profile and post metrics → engagement filtering
→ AI relevance review → spreadsheet or CRM → team notification

Limits and expectations

• TikTok changes its website and anti-bot behavior frequently; no scraper can guarantee 100% availability.
• Public, non-restricted profiles are supported. Private, login-only, age-restricted, region-restricted, or strongly rate-limited profiles may return an error result.
• popular sorts only the posts collected during the run; it does not discover every historical post.
• Media downloads, comments, subtitles, follower lists, and keyword-based creator discovery are not included in the current version.
• Profiles are processed sequentially at roughly 40-55 seconds each, so large profile lists take proportionally longer.
• Public metrics can change between runs and should be treated as snapshots.

Run locally

You need Python 3.11+ and Docker or a local Playwright installation.

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
playwright install chromium
apify actor:run

Run checks with:

pytest
ruff check .

Responsible use and support

Process only public data when you have a lawful purpose. Do not use this Actor for harassment, surveillance, discrimination, or attempts to access private content.

If a public profile repeatedly returns an error, open an issue on the Actor page and include the Apify run ID, input shape, and whether Automatic or Residential Proxy was selected. Never share credentials, cookies, API tokens, or sensitive personal information.