# TikTok follower counts for a list of accounts

**Use case:** 

One row per TikTok account with the exact follower, like, following and video counts (143,668, not 143.7K), the rounded figures TikTok shows beside them, the user id, secUid, verified and private flags, bio and created date. An account that does not exist or is private comes back as a typed row, free, so a long list of handles shows at once who is there and how big. Paste thousands.

## Input

```json
{
  "profiles": [
    "duolingo",
    "notionhq",
    "nba",
    "canva",
    "figma",
    "chipotle",
    "nike",
    "mrbeast",
    "zachking",
    "khaby.lame",
    "gordonramsayofficial",
    "framer",
    "baguettebae",
    "acme.widgets.hq"
  ],
  "readCountries": [
    "US"
  ],
  "maxVideosPerProfile": 0,
  "videoOrder": "latest",
  "excludePinned": false,
  "includeTranscripts": false,
  "downloadMedia": "none",
  "maxRepostsPerProfile": 0,
  "maxLikedPerProfile": 0,
  "includeStories": false,
  "includePlaylists": false,
  "maxFollowersPerProfile": 0,
  "maxFollowingPerProfile": 0,
  "outputFormat": "full",
  "maxItems": 100,
  "onlyChanged": false,
  "onlyNewVideos": false
}
```

## Output

```json
{
  "row_type": {
    "label": "Row type",
    "format": "string"
  },
  "input": {
    "label": "Input",
    "format": "string"
  },
  "profile_status": {
    "label": "Profile status",
    "format": "string"
  },
  "status_detail": {
    "label": "Status detail",
    "format": "string"
  },
  "read_country": {
    "label": "Read country",
    "format": "string"
  },
  "page_region": {
    "label": "Page region",
    "format": "string"
  },
  "scraped_at": {
    "label": "Scraped at",
    "format": "string"
  },
  "user_id": {
    "label": "User id",
    "format": "string"
  },
  "sec_uid": {
    "label": "secUid",
    "format": "string"
  },
  "username": {
    "label": "Username",
    "format": "string"
  },
  "nickname": {
    "label": "Name",
    "format": "string"
  },
  "bio": {
    "label": "Bio",
    "format": "string"
  },
  "bio_link": {
    "label": "Bio link",
    "format": "string"
  },
  "bio_link_risk": {
    "label": "Bio link risk",
    "format": "integer"
  },
  "profile_url": {
    "label": "Profile URL",
    "format": "string"
  },
  "avatar_url": {
    "label": "Avatar",
    "format": "string"
  },
  "avatar_medium_url": {
    "label": "Avatar 720 px",
    "format": "string"
  },
  "avatar_thumb_url": {
    "label": "Avatar 100 px",
    "format": "string"
  },
  "verified": {
    "label": "Verified",
    "format": "boolean"
  },
  "private_account": {
    "label": "Private",
    "format": "boolean"
  },
  "is_organization": {
    "label": "Organization",
    "format": "boolean"
  },
  "business_category": {
    "label": "Business category",
    "format": "string"
  },
  "commerce_user": {
    "label": "Business account",
    "format": "boolean"
  },
  "tt_seller": {
    "label": "TikTok Shop seller",
    "format": "boolean"
  },
  "language": {
    "label": "Language",
    "format": "string"
  },
  "created_at": {
    "label": "Created",
    "format": "string"
  },
  "username_modified_at": {
    "label": "Username changed",
    "format": "string"
  },
  "nickname_modified_at": {
    "label": "Name changed",
    "format": "string"
  },
  "followers": {
    "label": "Followers",
    "format": "integer"
  },
  "following": {
    "label": "Following",
    "format": "integer"
  },
  "likes": {
    "label": "Likes",
    "format": "integer"
  },
  "videos": {
    "label": "Videos",
    "format": "integer"
  },
  "friends": {
    "label": "Friends",
    "format": "integer"
  },
  "liked_videos": {
    "label": "Videos liked",
    "format": "integer"
  },
  "followers_shown": {
    "label": "Followers (as shown)",
    "format": "integer"
  },
  "following_shown": {
    "label": "Following (as shown)",
    "format": "integer"
  },
  "likes_shown": {
    "label": "Likes (as shown)",
    "format": "integer"
  },
  "videos_shown": {
    "label": "Videos (as shown)",
    "format": "integer"
  },
  "counts_precision": {
    "label": "Counts precision",
    "format": "string"
  },
  "live_room_id": {
    "label": "Live room id",
    "format": "string"
  },
  "is_live": {
    "label": "Live now",
    "format": "boolean"
  },
  "has_story": {
    "label": "Active story",
    "format": "boolean"
  },
  "comment_setting": {
    "label": "Who may comment",
    "format": "string"
  },
  "duet_setting": {
    "label": "Who may duet",
    "format": "string"
  },
  "stitch_setting": {
    "label": "Who may stitch",
    "format": "string"
  },
  "download_setting": {
    "label": "Who may download",
    "format": "string"
  },
  "following_visibility": {
    "label": "Following list",
    "format": "string"
  },
  "liked_public": {
    "label": "Liked tab public",
    "format": "boolean"
  },
  "embed_allowed": {
    "label": "Embeds allowed",
    "format": "boolean"
  },
  "playlists_tab": {
    "label": "Playlists tab",
    "format": "boolean"
  },
  "videos_requested": {
    "label": "Videos asked",
    "format": "integer"
  },
  "videos_delivered": {
    "label": "Videos delivered",
    "format": "integer"
  },
  "videos_route": {
    "label": "Videos route",
    "format": "string"
  },
  "videos_coverage": {
    "label": "Videos coverage",
    "format": "string"
  },
  "videos_note": {
    "label": "Videos note",
    "format": "string"
  },
  "engagement_videos": {
    "label": "Engagement: videos",
    "format": "integer"
  },
  "engagement_rate": {
    "label": "Engagement rate %",
    "format": "number"
  },
  "engagement_rate_followers": {
    "label": "Engagement per follower %",
    "format": "number"
  },
  "avg_plays": {
    "label": "Average plays",
    "format": "integer"
  },
  "median_plays": {
    "label": "Median plays",
    "format": "integer"
  },
  "avg_likes": {
    "label": "Average likes",
    "format": "integer"
  },
  "avg_comments": {
    "label": "Average comments",
    "format": "number"
  },
  "avg_shares": {
    "label": "Average shares",
    "format": "number"
  },
  "avg_saves": {
    "label": "Average saves",
    "format": "number"
  },
  "posts_per_week": {
    "label": "Posts per week",
    "format": "number"
  },
  "creator_score": {
    "label": "Creator score",
    "format": "integer"
  },
  "top_hashtags": {
    "label": "Top hashtags",
    "format": "array"
  },
  "top_content_categories": {
    "label": "Top content categories",
    "format": "array"
  },
  "posting_hours_utc": {
    "label": "Posting hours (UTC)",
    "format": "array"
  },
  "posting_weekdays_utc": {
    "label": "Posting weekdays (UTC)",
    "format": "array"
  },
  "followers_delivered": {
    "label": "Follower rows",
    "format": "integer"
  },
  "following_delivered": {
    "label": "Following rows",
    "format": "integer"
  },
  "reposts_delivered": {
    "label": "Repost rows",
    "format": "integer"
  },
  "liked_delivered": {
    "label": "Liked rows",
    "format": "integer"
  },
  "stories_delivered": {
    "label": "Story rows",
    "format": "integer"
  },
  "playlists_delivered": {
    "label": "Playlist rows",
    "format": "integer"
  },
  "change_type": {
    "label": "Change",
    "format": "string"
  },
  "changed_fields": {
    "label": "Changed fields",
    "format": "array"
  },
  "previous_read_at": {
    "label": "Previous delivery",
    "format": "string"
  },
  "previous_followers": {
    "label": "Previous followers",
    "format": "integer"
  },
  "followers_change": {
    "label": "Followers change",
    "format": "integer"
  },
  "followers_change_per_day": {
    "label": "Followers change per day",
    "format": "number"
  },
  "likes_change": {
    "label": "Likes change",
    "format": "integer"
  },
  "videos_change": {
    "label": "Videos change",
    "format": "integer"
  },
  "previous_handle": {
    "label": "Previous handle",
    "format": "string"
  },
  "first_read_at": {
    "label": "First read",
    "format": "string"
  },
  "times_read": {
    "label": "Times read",
    "format": "integer"
  },
  "count_history": {
    "label": "Count history",
    "format": "array"
  },
  "media_files": {
    "label": "Stored files",
    "format": "array"
  },
  "avatar_file_url": {
    "label": "Stored avatar",
    "format": "string"
  },
  "run_tag": {
    "label": "Run tag",
    "format": "string"
  },
  "video_source": {
    "label": "Video source",
    "format": "string"
  },
  "source_route": {
    "label": "Source route",
    "format": "string"
  },
  "playlist_id": {
    "label": "Playlist id",
    "format": "string"
  },
  "video_id": {
    "label": "Video id",
    "format": "string"
  },
  "video_url": {
    "label": "Video URL",
    "format": "string"
  },
  "caption": {
    "label": "Caption",
    "format": "string"
  },
  "text_language": {
    "label": "Caption language",
    "format": "string"
  },
  "plays": {
    "label": "Plays",
    "format": "integer"
  },
  "comments": {
    "label": "Comments",
    "format": "integer"
  },
  "shares": {
    "label": "Shares",
    "format": "integer"
  },
  "saves": {
    "label": "Saves",
    "format": "integer"
  },
  "reposts": {
    "label": "Reposts",
    "format": "integer"
  },
  "is_pinned": {
    "label": "Pinned",
    "format": "boolean"
  },
  "is_ad": {
    "label": "Ad",
    "format": "boolean"
  },
  "is_branded_content": {
    "label": "Branded content",
    "format": "boolean"
  },
  "ad_authorization": {
    "label": "Spark Ads authorized",
    "format": "boolean"
  },
  "is_slideshow": {
    "label": "Slideshow",
    "format": "boolean"
  },
  "has_shop_product": {
    "label": "Shop product",
    "format": "boolean"
  },
  "is_ai_generated": {
    "label": "AI-generated",
    "format": "boolean"
  },
  "ai_label": {
    "label": "AI label text",
    "format": "string"
  },
  "is_private_video": {
    "label": "Private video",
    "format": "boolean"
  },
  "duration_s": {
    "label": "Duration (s)",
    "format": "integer"
  },
  "width": {
    "label": "Width",
    "format": "integer"
  },
  "height": {
    "label": "Height",
    "format": "integer"
  },
  "definition": {
    "label": "Definition",
    "format": "string"
  },
  "video_format": {
    "label": "Format",
    "format": "string"
  },
  "size_bytes": {
    "label": "Size (bytes)",
    "format": "integer"
  },
  "bitrate": {
    "label": "Bitrate",
    "format": "integer"
  },
  "cover_url": {
    "label": "Cover",
    "format": "string"
  },
  "cover_720_url": {
    "label": "Cover 720 px",
    "format": "string"
  },
  "dynamic_cover_url": {
    "label": "Animated cover",
    "format": "string"
  },
  "play_url": {
    "label": "Play URL",
    "format": "string"
  },
  "download_url": {
    "label": "Download URL",
    "format": "string"
  },
  "media_expires_at": {
    "label": "Media links expire",
    "format": "string"
  },
  "caption_tracks": {
    "label": "Caption tracks",
    "format": "array"
  },
  "transcript": {
    "label": "Transcript",
    "format": "string"
  },
  "transcript_language": {
    "label": "Transcript language",
    "format": "string"
  },
  "music_id": {
    "label": "Music id",
    "format": "string"
  },
  "music_title": {
    "label": "Music title",
    "format": "string"
  },
  "music_author": {
    "label": "Music author",
    "format": "string"
  },
  "music_original": {
    "label": "Original sound",
    "format": "boolean"
  },
  "music_url": {
    "label": "Music URL",
    "format": "string"
  },
  "music_cover_url": {
    "label": "Music cover",
    "format": "string"
  },
  "music_duration_s": {
    "label": "Music duration (s)",
    "format": "integer"
  },
  "hashtags": {
    "label": "Hashtags",
    "format": "array"
  },
  "mentions": {
    "label": "Mentions",
    "format": "array"
  },
  "slideshow_images": {
    "label": "Slideshow images",
    "format": "array"
  },
  "anchors": {
    "label": "Anchors",
    "format": "array"
  },
  "poi_id": {
    "label": "Place id",
    "format": "string"
  },
  "poi_name": {
    "label": "Place",
    "format": "string"
  },
  "poi_address": {
    "label": "Place address",
    "format": "string"
  },
  "poi_city": {
    "label": "Place city",
    "format": "string"
  },
  "poi_category": {
    "label": "Place category",
    "format": "string"
  },
  "location_created": {
    "label": "Posted from",
    "format": "string"
  },
  "content_category": {
    "label": "Content category",
    "format": "integer"
  },
  "content_labels": {
    "label": "Content labels",
    "format": "array"
  },
  "duet_enabled": {
    "label": "Duets on",
    "format": "boolean"
  },
  "stitch_enabled": {
    "label": "Stitches on",
    "format": "boolean"
  },
  "share_enabled": {
    "label": "Sharing on",
    "format": "boolean"
  },
  "comments_enabled": {
    "label": "Comments on",
    "format": "boolean"
  },
  "can_repost": {
    "label": "Reposts on",
    "format": "boolean"
  },
  "author_id": {
    "label": "Author id",
    "format": "string"
  },
  "author_username": {
    "label": "Author",
    "format": "string"
  },
  "author_nickname": {
    "label": "Author name",
    "format": "string"
  },
  "author_verified": {
    "label": "Author verified",
    "format": "boolean"
  },
  "author_followers": {
    "label": "Author followers",
    "format": "integer"
  },
  "author_followers_shown": {
    "label": "Author followers (as shown)",
    "format": "integer"
  },
  "author_likes": {
    "label": "Author likes",
    "format": "integer"
  },
  "author_videos": {
    "label": "Author videos",
    "format": "integer"
  },
  "cover_file_url": {
    "label": "Stored cover",
    "format": "string"
  },
  "video_file_url": {
    "label": "Stored video",
    "format": "string"
  },
  "relation": {
    "label": "Relation",
    "format": "string"
  },
  "of_user_id": {
    "label": "Of user id",
    "format": "string"
  },
  "of_username": {
    "label": "Of username",
    "format": "string"
  },
  "playlist_name": {
    "label": "Playlist",
    "format": "string"
  },
  "playlist_url": {
    "label": "Playlist URL",
    "format": "string"
  },
  "playlist_video_count": {
    "label": "Playlist videos",
    "format": "integer"
  },
  "rowType": {
    "label": "rowType",
    "format": "string"
  },
  "id": {
    "label": "id",
    "format": "string"
  },
  "text": {
    "label": "text",
    "format": "string"
  },
  "textLanguage": {
    "label": "textLanguage",
    "format": "string"
  },
  "createTime": {
    "label": "createTime",
    "format": "integer"
  },
  "createTimeISO": {
    "label": "createTimeISO",
    "format": "string"
  },
  "isAd": {
    "label": "isAd",
    "format": "boolean"
  },
  "isPinned": {
    "label": "isPinned",
    "format": "boolean"
  },
  "isSponsored": {
    "label": "isSponsored",
    "format": "boolean"
  },
  "isSlideshow": {
    "label": "isSlideshow",
    "format": "boolean"
  },
  "playCount": {
    "label": "playCount",
    "format": "integer"
  },
  "diggCount": {
    "label": "diggCount",
    "format": "integer"
  },
  "commentCount": {
    "label": "commentCount",
    "format": "integer"
  },
  "shareCount": {
    "label": "shareCount",
    "format": "integer"
  },
  "collectCount": {
    "label": "collectCount",
    "format": "integer"
  },
  "repostCount": {
    "label": "repostCount",
    "format": "integer"
  },
  "detailedMentions": {
    "label": "detailedMentions",
    "format": "array"
  },
  "musicMeta": {
    "label": "musicMeta",
    "format": "object"
  },
  "videoMeta": {
    "label": "videoMeta",
    "format": "object"
  },
  "webVideoUrl": {
    "label": "webVideoUrl",
    "format": "string"
  },
  "mediaUrls": {
    "label": "mediaUrls",
    "format": "array"
  },
  "authorMeta": {
    "label": "authorMeta",
    "format": "object"
  },
  "fromProfileSection": {
    "label": "fromProfileSection",
    "format": "string"
  },
  "isStory": {
    "label": "isStory",
    "format": "boolean"
  },
  "readCountry": {
    "label": "readCountry",
    "format": "string"
  },
  "profileStatus": {
    "label": "profileStatus",
    "format": "string"
  },
  "hasTikTokShopProduct": {
    "label": "hasTikTokShopProduct",
    "format": "boolean"
  },
  "effectStickers": {
    "label": "effectStickers",
    "format": "array"
  },
  "commentsDatasetUrl": {
    "label": "commentsDatasetUrl",
    "format": "string"
  },
  "shortDramaSeriesInfo": {
    "label": "shortDramaSeriesInfo",
    "format": "object"
  }
}
```

## About this Actor

This example demonstrates how to use [TikTok User Profile Scraper — TikTok Followers, Videos, Stats](https://apify.com/hyperbach/tiktok-profile-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/hyperbach/tiktok-profile-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/hyperbach/tiktok-profile-scraper.md

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`).