# TikTok Video Lookup (`truefetch/tiktok-video-lookup`) Actor Decode any TikTok video URL — TikTok Score, Recommend Type, hidden SEO labels, audio metadata, top comments, and 50+ fields unavailable via the official API. $5.50 per 1,000. - **URL**: https://apify.com/truefetch/tiktok-video-lookup.md - **Developed by:** [TrueFetch](https://apify.com/truefetch) (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 $3.10 / 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/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 > **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected. [![TikTok Video Lookup](https://img.shields.io/badge/TikTok%20Video%20Lookup-010101?style=for-the-badge&logo=tiktok&logoColor=white)](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) [![TikTok Profile Video Scraper](https://img.shields.io/badge/TikTok%20Profile%20Video%20Scraper-1F8A70?style=for-the-badge)](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) [![$0.0055 per Video](https://img.shields.io/badge/$0.0055%20per%20Video-2E8B57?style=for-the-badge)](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) [![Videos, Reposts & Comments](https://img.shields.io/badge/Videos%20%7C%20Reposts%20%7C%20Comments-555555?style=for-the-badge)](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) [![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi) [![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor) ## TikTok Video Lookup — TikTok Profile Video Scraper: Videos, Reposts & Comments **Provide a TikTok profile URL and scrape any user's videos or reposts — with full engagement stats, hashtags, audio info, video specs, and optional comments — in clean structured JSON.** > **TL;DR (40-word answer):** TikTok Video Lookup is a no-login Apify Actor that scrapes TikTok profile videos and reposts at **$0.0055 per video** and **$0.0025 per comment batch**, returning play count, likes, shares, hashtags, video quality, and category. Last verified 2026-05-02. > **What it is NOT:** TikTok Video Lookup is _not_ a single-video downloader (use TikTok Video Downloader for that), _not_ a live stream recorder, and _not_ a hashtag search tool — it scrapes the video and repost list from a specific TikTok profile. > **TikTok Video Lookup is an Apify Actor that scrapes TikTok profile videos and reposts with detailed metadata including engagement stats, hashtags, audio info, and optional comments.** Maintained by TrueFetch on the Apify Store. --- ### 🏷️ Why choose TikTok Video Lookup **TikTok Video Lookup is best for** social media analysts, content researchers, and AI developers who need structured TikTok video datasets from specific user profiles. - **📊 Rich video metadata** — play count, like count, comment count, share count, category, hashtags, video specs (bitrate, codec, resolution), and more. - **💬 Optional comment scraping** — set `max_comments` to retrieve comment threads per video. - **⚡ Pay-per-result pricing** — **$0.0055 per video** and **$0.0025 per comment batch**. Free Apify plan includes $5/month credits ≈ 909 free video lookups. --- ### 🚀 Quick Start — run in 3 steps #### Run in Apify Console 1. **Open the Actor** — go to [TikTok Video Lookup on Apify](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) and click **Try for free**. 2. **Configure inputs** — enter a TikTok profile URL, choose `videos` or `reposts`, and set `max_videos` and `max_comments`. 3. **Click Start** — the Actor returns structured video records for the specified profile. #### Run via Apify API ```bash curl -X POST "https://api.apify.com/v2/acts/TrueFetch~tiktok-video-lookup/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "tiktok_url": "https://www.tiktok.com/@username", "content_type": "videos", "max_videos": 20, "max_comments": 0 }' ```` #### Run via MCP (for AI agents) TikTok Video Lookup is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/tiktok-video-lookup` and pass the same JSON input as above. *** ### ⚙️ Input parameters | Parameter | Type | Required | Default | Description | Example | | -------------- | ------- | :------: | ------- | ------------------------------------------------------------------ | ---------------------------------- | | `tiktok_url` | string | ✅ | — | TikTok profile or video URL (username is extracted automatically). | `https://www.tiktok.com/@username` | | `content_type` | string | ✅ | — | Content to scrape: `videos` (original posts) or `reposts`. | `videos` | | `max_videos` | integer | ✅ | — | Maximum number of videos to retrieve (minimum 1). | `20` | | `max_comments` | integer | ✅ | — | Maximum number of comments per video. `0` = skip comments. | `0` | ```json { "tiktok_url": "https://www.tiktok.com/@username", "content_type": "videos", "max_videos": 20, "max_comments": 0 } ``` *** ### 📦 Output dataset Each run writes one record per video to the **default Apify dataset**, exportable as JSON, JSONL, CSV, Excel, XML, RSS, or via the dataset API. | Field | Type | Always present? | Description | Example | | ------------------ | ------- | :-------------: | ------------------------------------------ | ------------------------------------------------- | | `processor` | string | ✅ | Apify Actor URL that produced this record. | `https://apify.com/TrueFetch/tiktok-video-lookup` | | `processed_at` | string | ✅ | ISO 8601 UTC timestamp. | `2026-04-24T09:30:00+00:00` | | `id` | string | optional | TikTok video ID. | `7123456789012345678` | | `url` | string | optional | Direct video URL. | `https://www.tiktok.com/@user/video/...` | | `created_at` | string | optional | Video creation timestamp (ISO 8601). | `2026-03-15T08:00:00+00:00` | | `description` | string | optional | Video caption/description. | `Morning routine 🌅 #fyp` | | `category` | string | optional | TikTok category label. | `lifestyle` | | `language` | string | optional | Detected caption language. | `en` | | `play_count` | integer | optional | Total plays. | `1500000` | | `like_count` | integer | optional | Total likes. | `85000` | | `comment_count` | integer | optional | Total comments. | `420` | | `share_count` | integer | optional | Total shares. | `3200` | | `collect_count` | integer | optional | Total saves/bookmarks. | `1200` | | `repost_count` | integer | optional | Total reposts. | `580` | | `duration` | integer | optional | Video duration in seconds. | `45` | | `width` | integer | optional | Video width in pixels. | `1080` | | `height` | integer | optional | Video height in pixels. | `1920` | | `quality` | string | optional | Video quality definition. | `720p` | | `format` | string | optional | Video file format. | `mp4` | | `hashtags` | array | optional | Hashtags in caption. | `["#morning", "#routine"]` | | `is_advertisement` | boolean | optional | Whether this is a paid ad. | `false` | | `is_ecommerce` | boolean | optional | Whether this is a TikTok Shop video. | `false` | #### Sample output ```json { "processor": "https://apify.com/TrueFetch/tiktok-video-lookup", "processed_at": "2026-04-24T09:30:00+00:00", "description": "Morning routine 🌅 #fyp", "play_count": 1500000, "like_count": 85000, "category": "lifestyle" } ``` *** ### 💡 Use cases #### For social media teams tracking TikTok content performance - **Problem:** a social media manager needs to monitor a competitor's latest TikTok videos and engagement metrics weekly. - **How TikTok Video Lookup solves it:** run with `content_type: "videos"` and `max_videos: 20` on a schedule to get the latest posts with full stats. - **Outcome:** weekly TikTok video performance dataset at **$0.0055 per video**. #### For researchers studying TikTok content categories - **Problem:** a researcher needs a dataset of 500 TikTok videos with categories, hashtags, and engagement across multiple creator profiles. - **How TikTok Video Lookup solves it:** run the Actor across multiple profiles to build a structured dataset with category labels, hashtags, and all engagement stats. - **Outcome:** 500-video research dataset at **$2.75 total** ($0.0055 × 500). #### For AI agents summarizing TikTok creator activity - **Problem:** LLM agents asked "what has this TikTok creator posted recently?" need structured video data. - **How TikTok Video Lookup solves it:** call the Actor over the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi) with the creator's TikTok URL. - **Outcome:** real-time TikTok creator video data grounded in AI assistants. *** ### 💰 Pricing, limits, and performance | Fact | Value | | --------------------------- | ------------------------------------------------------ | | Pricing model | Pay-per-result (event: `result`) | | Per-video price | **$0.0055 per video = $5.50 per 1,000** | | Per-comment-batch price | **$0.0025 per video with comments = $2.50 per 1,000** | | Free-tier monthly allowance | $5 Apify credits ≈ **~909 free video lookups / month** | | Free plan cap | 10 videos, 10 comments per run | | Output fields per video | **22** | | Login / cookies required | **No** — works without a TikTok account | | Export formats | JSON, JSONL, CSV, Excel, XML, RSS, dataset API | *** ### ⚖️ Compared with alternatives | Capability | **TikTok Video Lookup** | Manual browsing | Custom scraper | | ------------------------------------------------------ | :---------------------: | :-------------: | :--------------: | | Structured video stats (plays, likes, shares, collect) | ✅ | ❌ | you implement | | Category, hashtags, video specs | ✅ | ❌ | you implement | | Pay-per-video pricing | **$0.0055/video** | N/A | infra + dev cost | | Setup time to first result | **< 60 seconds** | minutes | days–weeks | **Verdict.** TikTok Video Lookup is ideal for social media analysts and AI developers who need structured TikTok video datasets from user profiles without building or maintaining a scraper. *** ### ⚠️ Common mistakes to avoid 1. **Missing required fields.** All four inputs (`tiktok_url`, `content_type`, `max_videos`, `max_comments`) are required. 2. **Setting `content_type` to anything other than `videos` or `reposts`.** Use exactly these two values. 3. **Setting `max_videos` below 1.** Minimum is 1. 4. **Setting `max_comments` to a negative number.** Use `0` to skip comments. *** ### 🛠️ Troubleshooting | Problem | Likely cause | Fix | | ----------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------- | | `Please enter a TikTok profile or video URL` | `tiktok_url` not provided. | Add `"tiktok_url": "https://www.tiktok.com/@username"` to your input. | | `Content type must be either Videos or Reposts` | Invalid `content_type` value. | Use `"videos"` or `"reposts"` exactly. | | `Please request at least 1 video` | `max_videos` is 0 or negative. | Set `max_videos` to at least 1. | | Empty dataset | Private profile or no public videos. | Check the TikTok profile is public and has posted content. | *** ### ❓ FAQ #### What is the difference between `videos` and `reposts` content types? `videos` returns the user's own original TikTok posts. `reposts` returns videos they have reshared from other creators. #### How much does TikTok Video Lookup cost? **$0.0055 per video** and **$0.0025 per video with comments**. The Apify Free plan includes $5/month credits ≈ 909 free video lookups. #### Is there a free-tier limit? Yes — free Apify plan users are capped at 10 videos and 10 comments per run. #### Does TikTok Video Lookup require a TikTok login? No — the Actor works without any TikTok account or login credentials. *** ### 🔌 Integrations TikTok Video Lookup plugs straight into the Apify ecosystem: - **Schedules** — run weekly to track a creator's latest TikTok videos ([docs](https://docs.apify.com/platform/schedules?fpr=aiagentapi)). - **Webhooks** — POST results to your endpoint on `ACTOR.RUN.SUCCEEDED` ([docs](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi)). - **Apify API** — `run-sync-get-dataset-items` for blocking calls, `runs` for async ([docs](https://docs.apify.com/api/v2?fpr=aiagentapi)). - **MCP Server** — call the Actor from Claude, ChatGPT, or Cursor agents ([docs](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi)). - **No-code** — Make, Zapier, n8n, Pipedream, Google Sheets, Airtable. *** ### 🧱 Sister Actors from TrueFetch #### Jobs - [Best Job Search](https://apify.com/TrueFetch/best-job-search?fpr=aiagentapi) - [Glassdoor Job Search](https://apify.com/TrueFetch/glassdoor-job-search?fpr=aiagentapi) - [Glints Company Finder](https://apify.com/TrueFetch/glints-company-finder?fpr=aiagentapi) - [Glints Job Finder](https://apify.com/TrueFetch/glints-job-finder?fpr=aiagentapi) - [Indeed Job Search](https://apify.com/TrueFetch/indeed-job-search?fpr=aiagentapi) - [JobStreet Company Finder](https://apify.com/TrueFetch/jobstreet-company-finder?fpr=aiagentapi) - [JobStreet Job Finder](https://apify.com/TrueFetch/jobstreet-job-finder?fpr=aiagentapi) - [LinkedIn Job Search](https://apify.com/TrueFetch/linkedin-job-search?fpr=aiagentapi) - [StepStone Company Finder](https://apify.com/TrueFetch/stepstone-company-finder?fpr=aiagentapi) - [StepStone Job Finder](https://apify.com/TrueFetch/stepstone-job-finder?fpr=aiagentapi) #### Shopping & Deals - [Amazon Deals Scraper](https://apify.com/TrueFetch/amazon-deals-scraper?fpr=aiagentapi) - [Amazon Store Finder](https://apify.com/TrueFetch/amazon-store-finder?fpr=aiagentapi) - [Argos Deals Scraper](https://apify.com/TrueFetch/argos-deals-scraper?fpr=aiagentapi) - [ASOS Fashion Scraper](https://apify.com/TrueFetch/asos-fashion-scraper?fpr=aiagentapi) - [eBay Deals Scraper](https://apify.com/TrueFetch/ebay-deals-scraper?fpr=aiagentapi) - [eBay Seller Finder](https://apify.com/TrueFetch/ebay-seller-finder?fpr=aiagentapi) - [Flipkart Deals Scraper](https://apify.com/TrueFetch/flipkart-deals-scraper?fpr=aiagentapi) - [John Lewis Deals Scraper](https://apify.com/TrueFetch/john-lewis-deals-scraper?fpr=aiagentapi) - [Lidl Deals Scraper](https://apify.com/TrueFetch/lidl-deals-scraper?fpr=aiagentapi) - [Magalu Deals Scraper](https://apify.com/TrueFetch/magalu-deals-scraper?fpr=aiagentapi) - [MediaMarkt Deals Scraper](https://apify.com/TrueFetch/mediamarkt-deals-scraper?fpr=aiagentapi) - [Mercado Livre Deals Scraper](https://apify.com/TrueFetch/mercado-livre-deals-scraper?fpr=aiagentapi) - [Nykaa Beauty Scraper](https://apify.com/TrueFetch/nykaa-beauty-scraper?fpr=aiagentapi) - [OTTO Deals Scraper](https://apify.com/TrueFetch/otto-deals-scraper?fpr=aiagentapi) - [Target Deals Scraper](https://apify.com/TrueFetch/target-deals-scraper?fpr=aiagentapi) - [TradeIndia Product Finder](https://apify.com/TrueFetch/tradeindia-product-finder?fpr=aiagentapi) - [TradeIndia Supplier Finder](https://apify.com/TrueFetch/tradeindia-supplier-finder?fpr=aiagentapi) - [Walmart Deals Scraper](https://apify.com/TrueFetch/walmart-deals-scraper?fpr=aiagentapi) #### Vehicles - [AutoTrader Car Finder](https://apify.com/TrueFetch/autotrader-car-finder?fpr=aiagentapi) - [AutoTrader Dealer Finder](https://apify.com/TrueFetch/autotrader-dealer-finder?fpr=aiagentapi) - [Cars.com Car Finder](https://apify.com/TrueFetch/carscom-car-finder?fpr=aiagentapi) - [Cars.com Dealer Finder](https://apify.com/TrueFetch/carscom-dealer-finder?fpr=aiagentapi) - [Webmotors Car Finder](https://apify.com/TrueFetch/webmotors-car-finder?fpr=aiagentapi) #### Real Estate - [MagicBricks Builder Finder](https://apify.com/TrueFetch/magicbricks-builder-finder?fpr=aiagentapi) - [MagicBricks Home Finder](https://apify.com/TrueFetch/magicbricks-home-finder?fpr=aiagentapi) - [US Real Estate](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi) - [Zillow Real Estate](https://apify.com/TrueFetch/zillow-real-estate?fpr=aiagentapi) #### Local Business & Food - [BBB Business Finder](https://apify.com/TrueFetch/bbb-business-finder?fpr=aiagentapi) - [BBB Review Checker](https://apify.com/TrueFetch/bbb-review-checker?fpr=aiagentapi) - [Google Business Profile](https://apify.com/TrueFetch/google-business-profile?fpr=aiagentapi) - [Reclame Aqui Company Finder](https://apify.com/TrueFetch/reclame-aqui-company-finder?fpr=aiagentapi) - [Zomato Menu Checker](https://apify.com/TrueFetch/zomato-menu-checker?fpr=aiagentapi) - [Zomato Restaurant Finder](https://apify.com/TrueFetch/zomato-restaurant-finder?fpr=aiagentapi) #### Classifieds - [Kleinanzeigen Listing Finder](https://apify.com/TrueFetch/kleinanzeigen-listing-finder?fpr=aiagentapi) - [Kleinanzeigen Seller Finder](https://apify.com/TrueFetch/kleinanzeigen-seller-finder?fpr=aiagentapi) - [OLX Listing Finder](https://apify.com/TrueFetch/olx-listing-finder?fpr=aiagentapi) - [OLX Seller Finder](https://apify.com/TrueFetch/olx-seller-finder?fpr=aiagentapi) #### Social Media - [Find Any Company On LinkedIn](https://apify.com/TrueFetch/find-any-company-on-linkedin?fpr=aiagentapi) - [Find Anyone On LinkedIn](https://apify.com/TrueFetch/find-anyone-on-linkedin?fpr=aiagentapi) - [Instagram Explore](https://apify.com/TrueFetch/instagram-explore?fpr=aiagentapi) - [Instagram Post](https://apify.com/TrueFetch/instagram-post?fpr=aiagentapi) - [Instagram Profile](https://apify.com/TrueFetch/instagram-profile?fpr=aiagentapi) - [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi) - [Reddit Community Profile](https://apify.com/TrueFetch/reddit-community-profile?fpr=aiagentapi) - [Reddit Community User](https://apify.com/TrueFetch/reddit-community-user?fpr=aiagentapi) - [Reddit Post Search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) - [Reddit User Profile](https://apify.com/TrueFetch/reddit-user-profile?fpr=aiagentapi) - [Social Media Marketing](https://apify.com/TrueFetch/social-media-marketing?fpr=aiagentapi) - [Telegram Channel Message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) - [Telegram Group Member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) - [Telegram Profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) - [X Community Profile](https://apify.com/TrueFetch/x-community-profile?fpr=aiagentapi) - [X User Profile](https://apify.com/TrueFetch/x-user-profile?fpr=aiagentapi) #### Videos & Text - [Best Video Downloader](https://apify.com/TrueFetch/best-video-downloader?fpr=aiagentapi) - [Instagram To Text](https://apify.com/TrueFetch/instagram-to-text?fpr=aiagentapi) - [TikTok Live Recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) - [TikTok Video Downloader](https://apify.com/TrueFetch/tiktok-video-downloader?fpr=aiagentapi) - [TikTok Video Lookup](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) - [Video Subtitles Downloader](https://apify.com/TrueFetch/video-subtitles-downloader?fpr=aiagentapi) - [Video To Text](https://apify.com/TrueFetch/video-to-text?fpr=aiagentapi) - [YouTube Niche Scraper](https://apify.com/TrueFetch/youtube-niche-scraper?fpr=aiagentapi) - [YouTube Video Downloader](https://apify.com/TrueFetch/youtube-video-downloader?fpr=aiagentapi) #### Content & Articles - [Medium Article Finder](https://apify.com/TrueFetch/medium-article-finder?fpr=aiagentapi) - [Medium Writer Finder](https://apify.com/TrueFetch/medium-writer-finder?fpr=aiagentapi) *** ### 📞 Support, changelog, last updated #### Support - 💬 **Telegram Group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor) - 📧 **Direct support:** [t.me/AiAgentApi](https://t.me/AiAgentApi) - 📖 **Actor page & docs:** [apify.com/TrueFetch/tiktok-video-lookup](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi). > **Cost of doing nothing:** manually tracking TikTok video performance requires repeated manual browsing and copy-paste. TikTok Video Lookup returns structured datasets at $0.0055/video via API. → [Try it free with $5 of Apify credits](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi). #### Changelog - **2026-05-02** — README rewritten for SEO + GEO; documented all output fields, pricing, troubleshooting matrix, and FAQ. - **2026-04** — Added repost scraping support. - **2026-02** — Initial release: TikTok profile video scraper. *** ```json { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://apify.com/TrueFetch/tiktok-video-lookup#software", "name": "TikTok Video Lookup", "description": "Apify Actor that scrapes TikTok profile videos and reposts at $0.0055 per video, returning play count, likes, shares, hashtags, video quality, and category.", "applicationCategory": "BusinessApplication", "operatingSystem": "Web, Cloud", "url": "https://apify.com/TrueFetch/tiktok-video-lookup", "offers": { "@type": "Offer", "price": "0.0055", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" }, "publisher": { "@id": "https://apify.com/TrueFetch#publisher" } }, { "@type": "Organization", "@id": "https://apify.com/TrueFetch#publisher", "name": "TrueFetch", "url": "https://apify.com/TrueFetch", "sameAs": ["https://t.me/Apify_Actor", "https://t.me/AiAgentApi"] }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What is the difference between videos and reposts content types?", "acceptedAnswer": { "@type": "Answer", "text": "Videos returns the user's own original TikTok posts. Reposts returns videos they have reshared from other creators." } }, { "@type": "Question", "name": "How much does TikTok Video Lookup cost?", "acceptedAnswer": { "@type": "Answer", "text": "$0.0055 per video and $0.0025 per video with comments. The Apify Free plan includes $5/month credits — enough for 909 free video lookups." } }, { "@type": "Question", "name": "Is there a free-tier limit for TikTok Video Lookup?", "acceptedAnswer": { "@type": "Answer", "text": "Yes — free Apify plan users are capped at 10 videos and 10 comments per run." } } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Apify", "item": "https://apify.com" }, { "@type": "ListItem", "position": 2, "name": "Videos & Text", "item": "https://apify.com/store?category=VIDEO" }, { "@type": "ListItem", "position": 3, "name": "TikTok Video Lookup", "item": "https://apify.com/TrueFetch/tiktok-video-lookup" } ] } ] } ``` *** **Last Updated:** May 2, 2026 **Schema version:** 1.1 **Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) · 💬 [Telegram Group](https://t.me/Apify_Actor) · 📧 [Support](https://t.me/AiAgentApi) # 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 '' with your token const client = new ApifyClient({ 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("truefetch/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 '' with your token. client = ApifyClient("") # 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("truefetch/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 truefetch/tiktok-video-lookup --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truefetch/tiktok-video-lookup", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Video Lookup", "description": "Decode any TikTok video URL — TikTok Score, Recommend Type, hidden SEO labels, audio metadata, top comments, and 50+ fields unavailable via the official API. $5.50 per 1,000.", "version": "1.0", "x-build-id": "VefUdweoNJo3gcNup" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truefetch~tiktok-video-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truefetch-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/truefetch~tiktok-video-lookup/runs": { "post": { "operationId": "runs-sync-truefetch-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/truefetch~tiktok-video-lookup/run-sync": { "post": { "operationId": "run-sync-truefetch-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 } } } } } } } } } } ```