# TikTok Video Lookup (`cheapget/tiktok-video-lookup`) Actor

Get the full story behind any TikTok video — internal TikTok Score, Recommend Type, hidden SEO data, audio metadata, full comments, and original music link. 50+ details per video.

- **URL**: https://apify.com/cheapget/tiktok-video-lookup.md
- **Developed by:** [CheapGET](https://apify.com/cheapget) (community)
- **Categories:** Social media, Videos, News
- **Stats:** 17 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.90 / 1,000 profiles

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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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 Video Lookup - Get Full TikTok Video Details & Hidden SEO Data

![Support](https://img.shields.io/badge/Support-24%2F7%20Online-blueviolet) ![Rating](https://img.shields.io/badge/Rating-⭐⭐⭐⭐⭐-yellow) ![Reliability](https://img.shields.io/badge/Reliability-99.9%25-28a745) ![TikTok Video Lookup](https://apify.com/actor-badge?actor=cheapget/tiktok-video-lookup&fpr=aiagentapi)

> **Get complete TikTok video details with 50+ data points per video — fast, cheap, and no login required.**

Search any public TikTok profile and get everything: video stats, hidden SEO titles, quality scores, recommendation types, full creator info, nested comments with replies, and music metadata. Perfect for checking out competitors, saving creator info, or researching trending content on TikTok.

### 🏆 Key Features

#### 📹 **Hidden SEO & Discovery Info**

- **🔍 TikTok SEO Titles**: See the hidden SEO titles and descriptions TikTok automatically creates for every video.
- **🏷️ SEO Tags & Keywords**: Find out which tags and keywords TikTok's algorithm assigns to each video for discovery.
- **📈 Quality Scores**: Check TikTok's internal quality score (VQScore) that shows how well a video performs.
- **🎯 Recommendation Types**: See how TikTok categorizes each video for recommendations (e.g., "gaming", "cross_promotion", "effect_related").

#### 📊 **Complete Video Details**

- **🎯 Engagement Stats**: Views, likes, comments, shares, saves, and repost counts — all the numbers you need.
- **📹 Technical Specs**: Video format, bitrate, codec, duration, resolution (height/width), file size, and quality rating.
- **🎵 Music Info**: Music ID, title, artist, duration, copyright status, and whether it can be used commercially.
- **🏷️ Content Tags**: Category, recommendation type, hashtags, mentions, and location info.

#### 🔄 **Full Creator Profile**

- **👤 Creator Stats**: Follower count, following, total likes, videos posted, and verification status.
- **⚙️ Privacy Settings**: Download permissions, comment settings, duet/stitch availability, and favorites visibility.
- **📊 Account Details**: Likes given, account type (private/secret), advertiser status, and bio info.

#### 💬 **Comments with Replies**

- **🗨️ Full Comment Threads**: Complete comment trees with parent-child relationships and reply chains.
- **📊 Comment Stats**: Like counts, reply counts, and comment quality scores per comment.
- **👤 Creator Interactions**: Pinned comments, creator-liked comments, and comment visibility status.
- **⏰ Timestamps**: When each comment was posted, in a clean date format.

### 💰 Pricing

| Resource        | Cost     | What You Get                                                              |
| --------------- | -------- | ------------------------------------------------------------------------- |
| **Actor Start** | $0.00005 | One-time charge when the Actor starts running                             |
| **Actor Usage** | $0.00001 | Covers runtime and storage — usually just a few cents per run             |
| **Profile**     | $0.0055  | Per video lookup — includes all video details, creator info, and SEO data |
| **Comment**     | $0.0025  | Per video with comments — get full comment threads with replies           |

**Example Cost:**

- Looking up 10 videos with comments
- Cost: $0.00005 + (10 × $0.0055) + (10 × $0.0025) = **$0.08005** + a few cents for runtime

### 🎯 Use Cases

#### Check Out Any TikTok Creator

Look up any public TikTok profile and get all their video details, follower counts, and engagement stats — perfect for researching creators you're interested in.

#### Find Trending Content Ideas

Browse popular TikTok profiles to see what's working — quality scores, recommendation types, and engagement patterns help you spot trends.

#### Save Music Info from TikTok Videos

Get the full music info for any TikTok video — artist name, title, copyright status, duration, and playback URL.

#### Read All Comments in One Place

Get every comment and reply from TikTok videos in an organized list — great for seeing what people think about a video.

#### Research TikTok SEO

Discover hidden SEO titles, descriptions, tags, and keywords that TikTok assigns to videos — useful for understanding how TikTok search works.

### 🌟 Why Choose This Actor

**Made for TikTok fans, creators, and curious users** who want quick access to detailed video info without logging in or using complicated tools.

| Feature         | TikTok Video Lookup   | Manual Browsing   | Exolyt            | SocialBlade      |
| :-------------- | :-------------------- | :---------------- | :---------------- | :--------------- |
| **Pricing**     | ✅ **Pay per use**    | ✅ Free           | ⚠️ Monthly plans  | ⚠️ Subscription  |
| **Data Depth**  | ✅ **50+ fields**     | ❌ Limited view   | ⚠️ Analytics only | ⚠️ Basic stats   |
| **Comments**    | ✅ **Nested replies** | ⚠️ Manual scroll  | ❌ Not available  | ❌ Not available |
| **SEO Data**    | ✅ **Included**       | ❌ Hidden         | ❌ Not available  | ❌ Not available |
| **Music Info**  | ✅ **Full metadata**  | ❌ Not possible   | ❌ Not supported  | ❌ Not supported |
| **Speed**       | ✅ **Instant**        | ❌ Manual copying | ⚠️ Delayed        | ⚠️ Delayed       |
| **Cost for 10** | ✅ **$0.06**          | ✅ Free           | ⚠️ $49/month      | ⚠️ $3.99/month   |

### 🚀 Quick Start

1. **Enter a TikTok profile URL** — paste any public TikTok profile link like `https://www.tiktok.com/@mrbeast`
2. **Click Start** — choose what you want (videos or reposts) and hit the Start button
3. **Download your results** — get all video details, comments, and music info in JSON, CSV, or Excel

### 💻 Input Parameters

[![TikTok Video Lookup input configuration showing 4 parameters: TikTok URL (profile link), Content Type (Videos/Reposts selector), Max Videos (number input), Max Comments (number input)](https://api.apify.com/v2/key-value-stores/TFqj8joTZ3NEhkoFS/records/tiktok-video-lookup_input.png)](https://apify.com/cheapget/tiktok-video-lookup?fpr=aiagentapi)

| Parameter      | Type    | Required | Description                                                                                            |
| -------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------ |
| `tiktok_url`   | string  | ✅ Yes   | TikTok profile URL or username. Supports formats: `https://www.tiktok.com/@username` or just @username |
| `content_type` | string  | ✅ Yes   | Which tab to browse on the TikTok profile. Videos = original posts, Reposts = reshared videos          |
| `max_videos`   | integer | ✅ Yes   | How many videos to find from the selected tab (sorted by newest first)                                 |
| `max_comments` | integer | ✅ Yes   | How many comments to get per video, including nested replies (set to 0 to skip comments)               |

#### 📝 Example Input

```json
{
  "tiktok_url": "https://www.tiktok.com/@mrbeast",
  "content_type": "Videos",
  "max_videos": 456,
  "max_comments": 789
}
````

### 📤 Output Structure

| Field                | Type    | Description                                                                                                       |
| -------------------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
| `processor`          | string  | URL of the Apify actor that processed this data                                                                   |
| `processed_at`       | string  | When the data was collected (format: YYYY-MM-DDTHH:MM:SS+00:00)                                                   |
| `id`                 | string  | Unique TikTok video identifier                                                                                    |
| `url`                | string  | TikTok video page URL (format: `https://www.tiktok.com/@username/video/id` or `/photo/id`)                        |
| `created_time`       | integer | Unix timestamp when the video was created                                                                         |
| `created_at`         | string  | ISO 8601 timestamp when the video was created (format: YYYY-MM-DDTHH:MM:SS+00:00)                                 |
| `description`        | string  | Video description/caption text                                                                                    |
| `quality_score`      | string  | TikTok internal video quality score, higher score indicates better quality                                        |
| `language`           | string  | ISO 639-1 language code of the video caption (e.g., 'en', 'es', 'zh', 'ja')                                       |
| `ai_topic`           | boolean | Whether the video has AI-generated topic                                                                          |
| `under_review`       | boolean | Whether the video is under review                                                                                 |
| `comment_enabled`    | string  | Comment status (open/restricted)                                                                                  |
| `share_enabled`      | boolean | Whether sharing is enabled                                                                                        |
| `repost_enabled`     | boolean | Whether reposting is enabled                                                                                      |
| `is_advertisement`   | boolean | Whether the video is an advertisement                                                                             |
| `is_original`        | boolean | Whether the video is original content                                                                             |
| `is_official`        | boolean | Whether the video is official content                                                                             |
| `is_private`         | boolean | Whether the video is private                                                                                      |
| `is_secret`          | boolean | Whether the video is secret                                                                                       |
| `is_ecommerce`       | boolean | Whether the video is e-commerce related                                                                           |
| `is_pinned`          | boolean | Whether the video is pinned on profile                                                                            |
| `play_count`         | integer | Number of times the video was played                                                                              |
| `like_count`         | integer | Number of likes the video received                                                                                |
| `comment_count`      | integer | Number of comments on the video                                                                                   |
| `share_count`        | integer | Number of times the video was shared                                                                              |
| `collect_count`      | integer | Number of times the video was collected/saved                                                                     |
| `repost_count`       | integer | Number of times the video was reposted                                                                            |
| `duet_enabled`       | boolean | Whether duets are enabled for this video                                                                          |
| `stitch_enabled`     | boolean | Whether stitches are enabled for this video                                                                       |
| `category`           | string  | TikTok video category assigned by the platform (e.g., 'dance', 'comedy', 'education', 'entertainment', 'gaming')  |
| `recommend_type`     | string  | TikTok recommendation algorithm category (e.g., 'for\_you', 'trending', 'gaming', 'viral', 'featured')             |
| `size`               | integer | Video file size in bytes                                                                                          |
| `format`             | string  | Video file format (e.g., mp4)                                                                                     |
| `bitrate`            | integer | Video bitrate in bits per second (bps)                                                                            |
| `codec`              | string  | Video codec type                                                                                                  |
| `cover`              | string  | URL of the video cover image                                                                                      |
| `duration`           | integer | Video duration in seconds                                                                                         |
| `height`             | integer | Video height in pixels                                                                                            |
| `width`              | integer | Video width in pixels                                                                                             |
| `quality`            | string  | Video quality definition                                                                                          |
| `original_audio`     | boolean | Whether the video has original audio                                                                              |
| `caption_reason`     | string  | Reason for caption availability (e.g., 'no\_speech', 'unsupported\_language', 'poor\_audio\_quality')                 |
| `image_post`         | array   | List of image URLs if this is an image carousel post (TikTok photo mode)                                          |
| `hashtags`           | array   | List of hashtags used in the video (without ## symbol)                                                             |
| `mentions`           | array   | List of mentioned usernames (without @ symbol)                                                                    |
| `anchors`            | array   | List of anchor links in the video description                                                                     |
| `location_name`      | string  | Location name where the video was recorded                                                                        |
| `location_city`      | string  | City where the video was recorded                                                                                 |
| `location_address`   | string  | Full address where the video was recorded                                                                         |
| `music_id`           | string  | Unique identifier for the music track                                                                             |
| `music_url`          | string  | Playback URL for the video's music/audio track                                                                    |
| `music_author`       | string  | Name of the music artist or creator                                                                               |
| `music_cover`        | string  | URL of the music cover image                                                                                      |
| `music_title`        | string  | Title of the music track                                                                                          |
| `music_duration`     | integer | Duration of the music track in seconds                                                                            |
| `music_original`     | boolean | Whether the music is original content                                                                             |
| `music_copyrighted`  | boolean | Whether the music is copyrighted                                                                                  |
| `music_commerce`     | boolean | Whether the music can be used for commercial purposes                                                             |
| `music_unlimited`    | boolean | Whether the music has unlimited usage rights                                                                      |
| `author_id`          | string  | Unique identifier for the video author                                                                            |
| `author_name`        | string  | Username of the video author (without @ symbol)                                                                   |
| `author_nickname`    | string  | Display name of the video author                                                                                  |
| `author_avatar`      | string  | URL of the author's profile picture                                                                               |
| `author_bio`         | string  | Biography text from the author's profile                                                                          |
| `author_download`    | string  | Download permission setting for the author's videos (e.g., 'allowed', 'disabled')                                 |
| `author_comment`     | string  | Comment permission setting (e.g., 'everyone', 'followers', 'off')                                                 |
| `author_duet`        | string  | Duet permission setting (e.g., 'everyone', 'followers', 'off')                                                    |
| `author_stitch`      | string  | Stitch permission setting (e.g., 'everyone', 'followers', 'off')                                                  |
| `author_favorites`   | boolean | Whether the author has favorites enabled                                                                          |
| `author_secret`      | boolean | Whether the author's account is secret                                                                            |
| `author_private`     | boolean | Whether the author's account is private                                                                           |
| `author_verified`    | boolean | Whether the author is verified                                                                                    |
| `author_advertiser`  | boolean | Whether the author is an advertiser                                                                               |
| `author_followers`   | integer | Number of followers the author has                                                                                |
| `author_following`   | integer | Number of accounts the author is following                                                                        |
| `author_likes`       | integer | Total number of likes received by the author                                                                      |
| `author_likes_given` | integer | Total number of likes given by the author                                                                         |
| `author_videos`      | integer | Total number of videos posted by the author                                                                       |
| `seo_title`          | string  | SEO-optimized title generated/assigned by TikTok for search engines                                               |
| `seo_description`    | string  | SEO-optimized description generated/assigned by TikTok for search engines                                         |
| `seo_tags`           | array   | SEO tags assigned by TikTok for video discovery and categorization                                                |
| `seo_keywords`       | array   | SEO keywords assigned by TikTok for search optimization                                                           |
| `comments`           | array   | List of comments on the video with nested replies (includes comment text, author, likes, reply count, timestamps) |

#### Comment Fields

| Field             | Type    | Description                                                      |
| ----------------- | ------- | ---------------------------------------------------------------- |
| `id`              | string  | Unique comment identifier                                        |
| `father_id`       | string  | Parent comment ID (0 for top-level comments)                     |
| `name`            | string  | Username of the commenter                                        |
| `text`            | string  | Comment text content                                             |
| `language`        | string  | ISO 639-1 language code of the comment                           |
| `created_at`      | string  | ISO 8601 timestamp when the comment was created                  |
| `like_count`      | integer | Number of likes on the comment                                   |
| `reply_count`     | integer | Number of replies to the comment                                 |
| `score`           | string  | Comment quality/engagement score                                 |
| `is_pinned`       | boolean | Whether the comment is pinned by the video author                |
| `is_author_liked` | boolean | Whether the video author liked this comment                      |
| `status`          | string  | Comment visibility status (e.g., 'visible', 'hidden', 'deleted') |

#### 📤 Example Output

```json
{
  "processor": "https://apify.com/cheapget/tiktok-video-lookup?fpr=aiagentapi",
  "processed_at": "2025-12-30T08:12:31+00:00",
  "id": "7554428159052008717",
  "url": "https://www.tiktok.com/@mrbeastlab/video/7554428159052008717",
  "created_time": 1758902387,
  "created_at": "2025-09-26T15:59:47+00:00",
  "description": "🔥 The wait is almost over! The all-new animated series, MrBeast Labs, premieres on the Beast Animations YouTube channel on Sunday, October 26. ⚡️ #MrBeastLabsToysPartner",
  "quality_score": "64.65",
  "language": "en",
  "ai_topic": false,
  "under_review": false,
  "comment_enabled": "open",
  "share_enabled": true,
  "repost_enabled": true,
  "is_advertisement": false,
  "is_original": false,
  "is_official": false,
  "is_private": false,
  "is_secret": false,
  "is_ecommerce": false,
  "is_pinned": false,
  "play_count": 560500,
  "like_count": 25100,
  "comment_count": 907,
  "share_count": 887,
  "collect_count": 1844,
  "repost_count": 0,
  "duet_enabled": false,
  "stitch_enabled": false,
  "category": "other",
  "recommend_type": "effect_related",
  "size": 11303921,
  "format": "mp4",
  "bitrate": 877812,
  "codec": "h264",
  "cover": "https://api.apify.com/v2/key-value-stores/cover.jpg",
  "duration": 103,
  "height": 1024,
  "width": 576,
  "quality": "540p",
  "original_audio": false,
  "caption_reason": "poor_audio_quality",
  "image_post": [
    "https://api.apify.com/v2/key-value-stores/1.jpg",
    "https://api.apify.com/v2/key-value-stores/2.jpg"
  ],
  "hashtags": ["mrbeastlabstoyspartner"],
  "mentions": ["mrbeast", "chandlerhallow", "karljacobs"],
  "anchors": [
    {
      "keyword": "MrBeast Merch",
      "description": "Official MrBeast merchandise store"
    }
  ],
  "location_name": "Riyadh",
  "location_city": "Riyadh",
  "location_address": "Saudi Arabia",
  "music_id": "7554428157340764942",
  "music_url": "https://api.apify.com/v2/key-value-stores/music.mp3",
  "music_author": "MrBeast Lab",
  "music_cover": "https://api.apify.com/v2/key-value-stores/cover.jpg",
  "music_title": "original sound - MrBeast Lab",
  "music_duration": 103,
  "music_original": true,
  "music_copyrighted": true,
  "music_commerce": true,
  "music_unlimited": false,
  "author_id": "7343380121988285482",
  "author_name": "mrbeastlab",
  "author_nickname": "MrBeast Lab",
  "author_avatar": "https://api.apify.com/v2/key-value-stores/avatar.jpg",
  "author_bio": "Action figures, collectibles and an all-new animated short series out now!",
  "author_download": "allowed",
  "author_comment": "everyone",
  "author_duet": "everyone",
  "author_stitch": "everyone",
  "author_favorites": false,
  "author_secret": false,
  "author_private": false,
  "author_verified": true,
  "author_advertiser": false,
  "author_followers": 173600,
  "author_following": 8,
  "author_likes": 157700,
  "author_likes_given": 161,
  "author_videos": 78,
  "seo_title": "MrBeast Labs Animated Series Premieres Soon!",
  "seo_description": "Don't miss the debut of MrBeast Labs on October 26! Exciting animations await! #MrBeastLabsToysPartner",
  "seo_tags": ["alpha-mr-beast", "mr-beast-members"],
  "seo_keywords": [" MrBeast YouTube channel", " upcoming animated shows"],
  "comments": [
    {
      "id": "7558561176227447565",
      "father_id": "0",
      "name": "goobygio",
      "text": "That voice actor sounds EXACTLY like Mr. Beast",
      "language": "en",
      "created_at": "2025-10-07T19:18:30+00:00",
      "like_count": 181,
      "reply_count": 5,
      "score": "0.0004",
      "is_pinned": false,
      "is_author_liked": false,
      "status": "visible"
    }
  ]
}
```

### 🔌 Integrations

Connect this actor to your favorite tools or use the API directly.

#### 🐍 Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")

run_input = {'tiktok_url': 'https://www.tiktok.com/@mrbeast',
 'content_type': 'Videos',
 'max_videos': 456,
 'max_comments': 789}

run = client.actor("cheapget/tiktok-video-lookup").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### 🟨 JavaScript / Node.js

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

const client = new ApifyClient({ token: "YOUR_APIFY_API_TOKEN" });

const run = await client.actor("cheapget/tiktok-video-lookup").call({
  runInput: {
    tiktok_url: "https://www.tiktok.com/@mrbeast",
    content_type: "Videos",
    max_videos: 456,
    max_comments: 789,
  },
});

for await (const item of client.dataset(run.defaultDatasetId).iterateItems()) {
  console.log(item);
}
```

#### 🌐 REST API (curl)

```bash
curl -X POST "https://api.apify.com/v2/acts/cheapget~tiktok-video-lookup/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tiktok_url": "https://www.tiktok.com/@mrbeast", "content_type": "Videos", "max_videos": 456, "max_comments": 789}'
```

#### Ⓜ️ Make.com Integration

**[Get Started with Make.com (1000 Free Credits)](https://www.make.com/en/register?pc=marketingme)** 🎁

```text
Step 1: Add the Make.com module "Run an Actor"
Step 2: Enable mapping and paste Actor ID `KdZEBj7bgFgCh2Mg1`
Step 3: Paste the input JSON and run synchronously
Step 4: Add "Get Dataset Items" with `defaultDatasetId`
```

#### 🎱 N8N.io Integration

**[Open Source Workflow Automation](https://n8n.io/)** ⚡

```text
Step 1: Add the Apify node "Run an Actor and get dataset"
Step 2: Set Selection Mode to By ID
Step 3: Paste Actor ID `KdZEBj7bgFgCh2Mg1`
Step 4: Add your input JSON and read items from `defaultDatasetId`
```

#### 📚 API Documentation

- **[Python API](https://apify.com/cheapget/tiktok-video-lookup/api/python?fpr=aiagentapi)** - Python client docs with examples
- **[JavaScript API](https://apify.com/cheapget/tiktok-video-lookup/api/javascript?fpr=aiagentapi)** - Node.js and browser guide
- **[REST API](https://apify.com/cheapget/tiktok-video-lookup/api?fpr=aiagentapi)** - Direct HTTP access

#### 🏗️ Metadata (JSON-LD)

```json
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "TikTok Video Lookup - Get Full TikTok Video Details",
  "applicationCategory": "UtilitiesApplication",
  "applicationSubCategory": "TikTok Video Lookup",
  "operatingSystem": "Cloud",
  "offers": {
    "@type": "Offer",
    "price": "0.00",
    "priceCurrency": "USD",
    "priceValidUntil": "2099-12-31",
    "availability": "https://schema.org/InStock"
  },
  "description": "Get complete TikTok video details with 50+ data points per video — hidden SEO data, full creator profiles, comments with replies, and music info.",
  "featureList": [
    "Hidden SEO Titles & Keywords",
    "Full Video Details & Stats",
    "Complete Creator Profiles",
    "Nested Comments with Replies",
    "Music Info & Cover Images"
  ],
  "keywords": "tiktok video lookup, tiktok profile search, tiktok seo data, tiktok comments, tiktok music info",
  "author": {
    "@type": "Organization",
    "name": "cheapget",
    "url": "https://apify.com/cheapget?fpr=aiagentapi"
  },
  "softwareVersion": "1.0.0",
  "datePublished": "2024-01-01",
  "dateModified": "2026-04-16"
}
```

### 🚀 Performance Tips

Get the best results while keeping costs low:

#### 💰 Save Money

- **Test First**: Start with 1-2 videos to check the output before running a big search
- **Limit Comments**: Set comment limits based on what you actually need (0 to skip entirely)

#### ⚡ Speed Up Your Search

- **Videos Tab**: The "Videos" tab usually loads faster than "Reposts"
- **Fewer Comments**: Lower comment limits make things run much faster
- **Start Small**: Test with a small number first, then increase once you know what you need

#### 🛡️ Data Quality

- **Public Profiles Only**: Only public profiles can be accessed — private accounts won't work
- **Recent Content**: Newer videos usually have the most complete info
- **Verified Accounts**: Verified creators often have richer SEO data

#### 📊 Best Practices

- **Rate Limits**: The actor handles rate limiting automatically with retries
- **Freshness**: Engagement stats reflect the numbers at the time you run it
- **Comment Depth**: Nested replies are fully included with parent-child links

### ❓ FAQ

#### What content types can I look up?

You can browse two types of content from any public TikTok profile: **Videos** (original posts) and **Reposts** (reshared content).

#### How many videos can I get?

There's no hard limit, but we recommend starting with 10-50 videos for testing. Large searches (100+) may take longer but are fully supported.

#### Are comments included?

Yes! Comments are fully included with nested reply threads, engagement stats, and creator interactions. You can control the number of comments per video or skip them entirely by setting `max_comments` to 0.

#### Can I download the actual video files?

This actor focuses on video details and metadata. For video downloads, use our [TikTok Video Downloader](https://apify.com/cheapget/tiktok-video-downloader?fpr=aiagentapi).

#### What about music info?

Music info (title, artist, duration, copyright status) is always included for every video. Music cover images are also saved to the key-value store automatically.

#### Is this free?

There's no subscription — you only pay per use. Looking up 10 videos costs about $0.06. See the [Pricing](#-pricing) section for details.

#### How accurate is the data?

All data comes directly from TikTok, ensuring 100% accuracy. Engagement stats reflect the real-time numbers at the moment you run it.

#### What output formats are available?

Results come in JSON format by default. You can also download as CSV or Excel using Apify's built-in export features.

#### How long does it take?

Processing time depends on how many videos and comments you want:

- 10 videos without comments: 1-2 minutes
- 10 videos with 20 comments each: 3-5 minutes
- 50 videos with comments: 10-15 minutes

#### What are the SEO fields?

SEO fields (title, description, tags, keywords) are hidden info that TikTok's algorithm automatically creates for every video to help with search and discovery. Most people never see this data — but this actor reveals it.

### 🏷️ SEO Keywords

**🔑 Primary Keywords:** tiktok video lookup, tiktok profile search, tiktok video details, tiktok seo data, tiktok comments, tiktok music info, free tiktok tool

**🔍 Long-Tail Keywords:** get tiktok video details free, find tiktok hidden seo data, search tiktok profile videos, check tiktok video quality score, tiktok recommendation type lookup, tiktok creator profile search, get tiktok comments with replies, tiktok music info lookup

**🏢 Industry Keywords:** tiktok research, tiktok trending, tiktok content ideas, tiktok creator info, tiktok video stats, tiktok engagement numbers, tiktok video info

**🌍 Location Keywords:** tiktok profiles united states, tiktok creators uk, tiktok profile search worldwide, tiktok videos india, tiktok profiles any country, tiktok creators global

**💡 Use Case Keywords:** check tiktok creator stats, find trending tiktok content, look up tiktok video seo, get tiktok music info, read tiktok comments offline, search tiktok profiles, get tiktok video info fast

### ⚖️ Legal & Compliance

This actor accesses **publicly available data only**. It does not bypass logins, access private content, or violate platform terms. You are responsible for:

- **Data Rights**: Making sure you have permission to collect and use the data
- **Privacy Compliance**: Following GDPR, CCPA, and other applicable privacy laws when handling personal data
- **Platform Terms**: Respecting the platform's terms of service and usage policies
- **Ethical Use**: Using the data responsibly and in compliance with applicable laws

Need help or have compliance questions? [Contact us](https://t.me/AiAgentApi).

### 🔗 Related Actors

**💼 Jobs**

- [Best Job Search](https://apify.com/cheapget/best-job-search?fpr=aiagentapi) - Find jobs on LinkedIn, Indeed, Glassdoor, and more — free and fast, with salary info
- [Glassdoor Job Search](https://apify.com/cheapget/glassdoor-job-search?fpr=aiagentapi) - Search Glassdoor jobs with salary ranges, company ratings, and reviews
- [Indeed Job Search](https://apify.com/cheapget/indeed-job-search?fpr=aiagentapi) - Find Indeed job listings with salaries, company details, and apply links
- [LinkedIn Job Search](https://apify.com/cheapget/linkedin-job-search?fpr=aiagentapi) - Search LinkedIn jobs with applicant counts, company info, and seniority levels

**🎬 Videos**

- [Best Video Downloader](https://apify.com/cheapget/best-video-downloader?fpr=aiagentapi) - Download videos from 1000+ platforms with quality options and thumbnails
- [TikTok Video Downloader](https://apify.com/cheapget/tiktok-video-downloader?fpr=aiagentapi) - Download TikTok videos without watermarks plus comments and music info
- [YouTube Video Downloader](https://apify.com/cheapget/youtube-video-downloader?fpr=aiagentapi) - Download YouTube videos in multiple qualities with comments and thumbnails
- [Video Subtitles Downloader](https://apify.com/cheapget/video-subtitles-downloader?fpr=aiagentapi) - Get subtitles from any video URL as downloadable text
- [TikTok Live Recorder](https://apify.com/cheapget/tiktok-live-recorder?fpr=aiagentapi) - Record TikTok live streams with creator and engagement info
- [TikTok Video Lookup](https://apify.com/cheapget/tiktok-video-lookup?fpr=aiagentapi) - Get full TikTok video details with hidden SEO data and music info
- [YouTube Niche Scraper](https://apify.com/cheapget/youtube-niche-scraper?fpr=aiagentapi) - Find YouTube videos by keyword and get channel details, contact info, and stats
- [Video To Text](https://apify.com/cheapget/video-to-text?fpr=aiagentapi) - Turn any video into text with timestamps and language support
- [Instagram To Text](https://apify.com/cheapget/instagram-to-text?fpr=aiagentapi) - Turn Instagram videos into text for captions, research, or saving

**📱 Social Media**

- [Social Media Marketing](https://apify.com/cheapget/social-media-marketing?fpr=aiagentapi) - Create ready-to-post marketing content from any source with multiple styles
- [Find Any Company On LinkedIn](https://apify.com/cheapget/find-any-company-on-linkedin?fpr=aiagentapi) - Look up any company on LinkedIn with employee counts, locations, and updates
- [Find Anyone On LinkedIn](https://apify.com/cheapget/find-anyone-on-linkedin?fpr=aiagentapi) - Look up anyone on LinkedIn with work history, skills, and contact info
- [X Community Profile](https://apify.com/cheapget/x-community-profile?fpr=aiagentapi) - Check out X community details including members, rules, and activity
- [X User Profile](https://apify.com/cheapget/x-user-profile?fpr=aiagentapi) - Look up any X user profile with follower counts, bio, and pinned posts

**🔴 Reddit**

- [Reddit User Profile](https://apify.com/cheapget/reddit-user-profile?fpr=aiagentapi) - Look up any Reddit user with karma, trophies, and post history
- [Reddit Community Profile](https://apify.com/cheapget/reddit-community-profile?fpr=aiagentapi) - Check out subreddit details including rules, wiki, and pinned posts
- [Reddit Community Post](https://apify.com/cheapget/reddit-community-post?fpr=aiagentapi) - Browse subreddit posts with comments, votes, and author info
- [Reddit Post Search](https://apify.com/cheapget/reddit-post-search?fpr=aiagentapi) - Search Reddit posts by keyword with engagement stats and comments
- [Reddit Community User](https://apify.com/cheapget/reddit-community-user?fpr=aiagentapi) - Find active users in any subreddit with karma and profile details

**💬 Telegram**

- [Telegram Group Member](https://apify.com/cheapget/telegram-group-member?fpr=aiagentapi) - Find members of any public Telegram group with profile details
- [Telegram Channel Message](https://apify.com/cheapget/telegram-channel-message?fpr=aiagentapi) - Get Telegram channel messages with views, replies, and reactions
- [Telegram Profile](https://apify.com/cheapget/telegram-profile?fpr=aiagentapi) - Look up Telegram profiles for users, groups, bots, and channels

**📍 Local & Real Estate**

- [Google Business Profile](https://apify.com/cheapget/google-business-profile?fpr=aiagentapi) - Find local businesses on Google with reviews, ratings, photos, and contact info
- [Zillow Real Estate](https://apify.com/cheapget/zillow-real-estate?fpr=aiagentapi) - Search Zillow listings with prices, photos, home values, and property details
- [US Real Estate](https://apify.com/cheapget/us-real-estate?fpr=aiagentapi) - Find US property listings with prices, specs, agent info, and home values

### 🤝 Support & Community

**📧 Support**: [Contact Us](https://t.me/AiAgentApi) **💬 Community**: [Telegram Group](https://t.me/Apify_Actor)

***

**Last Updated:** April 16, 2026

# Actor input Schema

## `tiktok_url` (type: `string`):

TikTok profile URL or username. Supports formats: https://www.tiktok.com/@username or just @username

## `content_type` (type: `string`):

Select which tab to browse from the TikTok profile page. Videos = user's original posts, Reposts = videos the user reshared

## `max_videos` (type: `integer`):

Maximum number of videos to find from the selected content type tab (sorted by newest first)

## `max_comments` (type: `integer`):

Maximum comments to get per video including nested replies (set to 0 to skip comments)

## Actor input object example

```json
{
  "tiktok_url": "https://www.tiktok.com/@mrbeast",
  "content_type": "Videos",
  "max_videos": 1,
  "max_comments": 1
}
```

# Actor output Schema

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

All TikTok video details with engagement stats, SEO data, music info, author profiles, and comments

# 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": "https://www.tiktok.com/@mrbeast",
    "content_type": "Videos",
    "max_videos": 1,
    "max_comments": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("cheapget/tiktok-video-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": "https://www.tiktok.com/@mrbeast",
    "content_type": "Videos",
    "max_videos": 1,
    "max_comments": 1,
}

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

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": "https://www.tiktok.com/@mrbeast",
  "content_type": "Videos",
  "max_videos": 1,
  "max_comments": 1
}' |
apify call cheapget/tiktok-video-lookup --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=cheapget/tiktok-video-lookup",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "TikTok Video Lookup",
        "description": "Get the full story behind any TikTok video — internal TikTok Score, Recommend Type, hidden SEO data, audio metadata, full comments, and original music link. 50+ details per video.",
        "version": "0.0",
        "x-build-id": "EYh3beaj5TQs5DD4R"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/cheapget~tiktok-video-lookup/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-cheapget-tiktok-video-lookup",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/cheapget~tiktok-video-lookup/runs": {
            "post": {
                "operationId": "runs-sync-cheapget-tiktok-video-lookup",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/cheapget~tiktok-video-lookup/run-sync": {
            "post": {
                "operationId": "run-sync-cheapget-tiktok-video-lookup",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "tiktok_url",
                    "content_type",
                    "max_videos",
                    "max_comments"
                ],
                "properties": {
                    "tiktok_url": {
                        "title": "TikTok URL",
                        "type": "string",
                        "description": "TikTok profile URL or username. Supports formats: https://www.tiktok.com/@username or just @username"
                    },
                    "content_type": {
                        "title": "Content Type",
                        "enum": [
                            "Videos",
                            "Reposts"
                        ],
                        "type": "string",
                        "description": "Select which tab to browse from the TikTok profile page. Videos = user's original posts, Reposts = videos the user reshared"
                    },
                    "max_videos": {
                        "title": "Max Videos",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of videos to find from the selected content type tab (sorted by newest first)"
                    },
                    "max_comments": {
                        "title": "Max Comments",
                        "minimum": 0,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum comments to get per video including nested replies (set to 0 to skip comments)"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
