# TikTok Profile & Videos API (`deepmine/tiktok-profile-videos`) Actor Get TikTok profiles and their latest videos: followers, likes, bio, bio link, verified badge, and every video's plays, likes, comments, shares, caption, hashtags, sound and cover. Usernames or profile URLs in, clean JSON out. No login. - **URL**: https://apify.com/deepmine/tiktok-profile-videos.md - **Developed by:** [DeepMine](https://apify.com/deepmine) (community) - **Categories:** Social media, Videos - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 videos 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## TikTok Profile & Videos API Get **TikTok profiles** and their **latest videos** as clean rows: every video's plays, likes, comments, shares, saves, caption, hashtags, mentions, sound, cover and post date, and each creator's followers, following, total likes, video count, bio, bio link, verified badge and join date. Paste usernames or profile URLs. No TikTok account, no cookies, no login. | Creator | Caption | ▢️ Plays | ❀️ Likes | πŸ’¬ Comments | πŸ“… Posted | πŸ“Œ Pinned | |---|---|---:|---:|---:|---|---| | [@zachking](https://www.tiktok.com/@zachking/video/7655004069190192398) | a message to all AI | 67,300,000 | 13,900,000 | 105,300 | 2026-06-24 | yes | | [@zachking](https://www.tiktok.com/@zachking/video/7686898345519942925) | when you give your friend the aux cord… | 15,600,000 | 2,700,000 | 6,115 | 2026-09-18 | no | | [@khaby.lame](https://www.tiktok.com/@khaby.lame/video/7689510970292489502) | Ye… I’m gonna mind my business #learnfromkhaby #co… | 3,800,000 | 525,000 | 12,200 | 2026-09-25 | no | Collected 2026-09-27 with `{"profiles": ["zachking", "khaby.lame"], "maxVideosPerProfile": 15}`. Every video row also has shares, saves, the creator's follower count, duration, hashtags, mentions, sound and cover; each profile gets one row of its own in the πŸ‘€ Profiles dataset. **$0.80 per 1,000 videos** on the Starter plan ($1.00 Free, $0.60 Scale, $0.50 Business); profile rows are free with videos. The prefilled run (2 profiles, 100 videos) costs about $0.08. ### Why this one - **Videos and profiles, each in their own table.** Videos go to the main dataset; each creator's profile (followers, following, likes, videos, bio, bio link, join date) goes once to a separate **πŸ‘€ Profiles** dataset, free with every video run. - **Exact follower and like totals.** Profile counters are TikTok's exact numbers (86,878,951 followers for @zachking, not "86.9M"). - **Date filter.** `postedAfter` stops at the first video older than your date, so a daily or weekly monitor only pays for new posts. - **Profile-only mode.** Set `maxVideosPerProfile` to `0` to get just the profile rows: a quick way to enrich influencer lists. - **Sponsored posts flagged.** `isAd` marks posts TikTok labels as an ad or paid partnership. - **Fails loudly, never silently.** Every run saves a per-profile summary (`OUTPUT`) with its status (ok, not found, private, blocked) and why it stopped. If TikTok refuses a profile on every retry, the run is marked failed instead of quietly returning less. - **Fast and light.** Plain HTTP, no browser. ### Input | Field | What it does | Default | |---|---|---| | `profiles` | Usernames (with or without `@`) or profile URLs, e.g. `zachking`, `@khaby.lame`, `https://www.tiktok.com/@tiktok`. `vm.tiktok.com` short links to a profile work too. | `zachking`, `khaby.lame` | | `maxVideosPerProfile` | Newest videos per profile (pinned videos come first, as on TikTok). `0` = profile rows only. Up to 5,000. | 50 | | `postedAfter` | Skip videos posted before this date (`YYYY-MM-DD`). Via the API you can also pass `7 days`, `12 hours`, ... Older pinned videos are skipped, not counted. | – | | `proxyConfiguration` | Apify Proxy. Datacenter (the default) works; switch to residential only if a run reports blocks. | Apify datacenter | Example: ```json { "profiles": ["zachking", "https://www.tiktok.com/@khaby.lame"], "maxVideosPerProfile": 100, "postedAfter": "2026-09-01" } ``` ### Output Two datasets, profile by profile in your order: - **🎬 Videos** (the default dataset): one row per video, each profile's videos in TikTok's order (pinned first, then newest first). Views: **πŸ“Š Overview** (πŸ–ΌοΈ Cover, 🏷️ Username, πŸ‘€ Creator, πŸ“ Caption, πŸ”— TikTok, πŸ“Œ Pinned, πŸ“’ Ad, ▢️ Plays, ❀️ Likes, πŸ’¬ Comments, πŸ” Shares, πŸ“… Posted) and **πŸ“ˆ Stats** (🏷️ Username, πŸ”— TikTok, ▢️ Plays, ❀️ Likes, πŸ’¬ Comments, πŸ” Shares, πŸ”– Saves, πŸ‘₯ Followers, ⏱️ Duration, πŸ“… Posted). - **πŸ‘€ Profiles**: one row per profile. View **πŸ“Š Overview**: πŸ–ΌοΈ Photo, 🏷️ Username, πŸ‘€ Name, πŸ“ Bio, πŸ”— TikTok, βœ”οΈ Verified, πŸ‘₯ Followers, βž• Following, ❀️ Likes, 🎬 Videos, πŸ“… Joined, 🌐 Bio Link. With `maxVideosPerProfile: 0` the profile rows are what you get: they go to the default dataset (its **πŸ‘€ Profiles** view shows them; these are the rows you pay for) and, as always, to the πŸ‘€ Profiles dataset. A value TikTok didn't send is `null` (never an empty string or a made-up 0). #### Video fields - `cover`: the video's cover image. - `authorName`: the creator's display name. - `caption`: the full caption, hashtags included. - `captionSnippet`: the caption's first 50 characters on one line, for tables. - `authorUsername`: the creator's TikTok username, without @. - `videoUrl`: the video's page on TikTok. - `authorVerified`: the creator has TikTok's verified badge. - `isPinned`: pinned to the top of the profile. - `isAd`: TikTok labels the post as an ad or a paid partnership. - `plays`: views. - `likes`: likes. - `comments`: comments. - `shares`: shares. - `saves`: saves (TikTok's Favorites). - `authorFollowers`: the creator's followers (exact) when the video was collected. - `durationSeconds`: length in seconds (`null` for photo posts). - `postedAt`: when it was posted (UTC). - `hashtags`: hashtags in the caption, without #. - `mentions`: usernames mentioned in the caption. - `soundTitle`: the sound's title ("original sound" is the creator's own audio). - `soundUrl`: the sound's page on TikTok. - `photos`: the images of a photo post (slideshow); `null` for videos. - `videoId`: TikTok's video ID. - `scrapedAt`: when it was collected (UTC). #### Profile fields - `avatar`: profile picture. - `name`: display name. - `bio`: the full bio. - `bioSnippet`: the bio's first 50 characters on one line, for tables. - `username`: TikTok username, without @. - `profileUrl`: the profile on TikTok. - `verified`: TikTok's verified badge. - `followers`: followers (exact). - `following`: accounts they follow. - `likes`: total likes on all their videos. - `videos`: public videos. - `joinedAt`: when the account was created (UTC). - `bioLinkUrl`: the link in their bio. - `userId`: TikTok's user ID. - `secUid`: TikTok's secUid, the ID its own web API uses. - `scrapedAt`: when it was collected (UTC). Example video row: ```json { "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-...", "authorName": "Zach King", "caption": "a message to all AI", "captionSnippet": "a message to all AI", "authorUsername": "zachking", "videoUrl": "https://www.tiktok.com/@zachking/video/7655004069190192398", "authorVerified": true, "isPinned": true, "isAd": false, "plays": 67300000, "likes": 13900000, "comments": 105300, "shares": 560600, "saves": 1013163, "authorFollowers": 86878951, "durationSeconds": 27, "postedAt": "2026-06-24T16:45:49Z", "hashtags": null, "mentions": null, "soundTitle": "original sound", "soundUrl": "https://www.tiktok.com/music/original-sound-7655004159753718541", "photos": null, "videoId": "7655004069190192398", "scrapedAt": "2026-09-27T19:07:41Z" } ``` Example profile row: ```json { "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/...", "name": "Zach King", "bio": "Bringing a little more wonder into the world, 15 seconds at a time", "bioSnippet": "Bringing a little more wonder into the world, 15 s…", "username": "zachking", "profileUrl": "https://www.tiktok.com/@zachking", "verified": true, "followers": 86878951, "following": 182, "likes": 1301298065, "videos": 617, "joinedAt": "2016-02-29T07:29:22Z", "bioLinkUrl": "https://youtu.be/ulVscDewRPI?si=-65KnrnwSiGHDeT2", "userId": "68616495085350913", "secUid": "MS4wLjABAAAANnzJ9pdfxtlf3m5Ku_M-rCXVitJC13w4GavqyUD3RE8h1cZ-7O9FT-uQ9rCJjU_E", "scrapedAt": "2026-09-27T19:07:41Z" } ``` Notes: - A video's own counters are rounded by TikTok on its web pages when they're large (411.7K plays shows as `411700`); small numbers are exact. Now and then TikTok sends a video's plays, likes, shares and saves as 0 next to real comments; those come as `null`. - **Image links expire.** `cover`, `photos` and `avatar` are signed by TikTok and stop working about 2 days after the run. Download the images you need soon after the run. - Private accounts are hidden from logged-out visitors, so they're reported as `private` in `OUTPUT` with no rows (also with `maxVideosPerProfile: 0`), and they cost nothing. #### Run summary (`OUTPUT`) ```json { "results": 210, "inputs": [ {"input": "zachking", "status": "ok", "results": 70, "stopReason": "max_results", "username": "zachking"}, {"input": "some_private_user", "status": "private", "results": 0, "stopReason": "private", "error": "account is private"} ] } ``` `status` per profile: `ok`, `not_found`, `private`, `invalid` (not a username or profile URL), `blocked` (TikTok refused it on every retry; the run fails so you notice), `stopped` (your spending limit was reached). `stopReason` for `ok` profiles: `max_results`, `posted_after`, `end` (no more videos) or `profile_only`. ### Pricing Pay per result, no start fee and no minimum. Example: 1,000 videos cost $0.80 on the Starter plan. | Your Apify plan | Per 1,000 videos (or profiles in profile-only mode) | |---|---| | Free | $1.00 | | Starter | $0.80 | | Scale | $0.60 | | Business | $0.50 | You pay only for rows that reach your dataset. Profile rows that come with a video run are free; in profile-only mode (`maxVideosPerProfile: 0`) each profile row costs the same as a video. Not-found, private and invalid inputs cost nothing. When your spending limit is reached, the run stops. ### FAQ **Do I need a TikTok account?** No. The Actor reads only what TikTok shows logged-out visitors. **How many videos can I get per profile?** As many as the profile shows publicly, up to 5,000 per profile per run. In our tests TikTok served every page we asked for (350+ videos from @tiktok). **Can I monitor creators?** Yes: schedule a daily run with `postedAfter: "2 days"` (via the API or a saved task) and dedupe on `videoId`. **How do I join videos to profiles?** Both tables carry the username: `authorUsername` on videos, `username` on profiles. **Comments and followers?** Not in this Actor. ### Feedback Missing a field, or a result that doesn't look right? Open an issue on the **Issues** tab and we'll look into it. If the data helps you, a short review on this page helps other people find it. # Actor input Schema ## `profiles` (type: `array`): TikTok usernames (with or without @) or profile URLs, one per line. Example: zachking or https://www.tiktok.com/@zachking ## `maxVideosPerProfile` (type: `integer`): Newest videos to get per profile (pinned videos come first, as on TikTok). 0 = profile details only, one row per profile. You pay per video. ## `postedAfter` (type: `string`): Skip videos posted before this date (YYYY-MM-DD). Via the API you can also pass a relative time such as '7 days' or '12 hours'. Leave empty for all. ## `proxyConfiguration` (type: `object`): TikTok is reached through Apify Proxy. Datacenter proxies (the default) work for these pages; switch to residential only if your runs report blocks. ## Actor input object example ```json { "profiles": [ "zachking", "khaby.lame" ], "maxVideosPerProfile": 50, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): No description ## `profiles` (type: `string`): No description ## `summary` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "profiles": [ "zachking", "khaby.lame" ], "maxVideosPerProfile": 50, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("deepmine/tiktok-profile-videos").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "profiles": [ "zachking", "khaby.lame", ], "maxVideosPerProfile": 50, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("deepmine/tiktok-profile-videos").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 '{ "profiles": [ "zachking", "khaby.lame" ], "maxVideosPerProfile": 50, "proxyConfiguration": { "useApifyProxy": true } }' | apify call deepmine/tiktok-profile-videos --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepmine/tiktok-profile-videos" } } } ``` 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 ` 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/JLnq1HaVmavE5I4Ao/builds/fDOgZCUjd1sZ0z58S/openapi.json