# Tiktok Video Details Scraper Pro (`alpha-scraper/tiktok-video-details-scraper-pro`) Actor Tiktok Video Details Scraper Pro extracts structured metadata from one or more TikTok video URLs, including captions, engagement metrics, creator data, music details, video properties, hashtags, timestamps, media URLs, and content flags for research and analysis. - **URL**: https://apify.com/alpha-scraper/tiktok-video-details-scraper-pro.md - **Developed by:** [Alpha Scraper](https://apify.com/alpha-scraper) (community) - **Categories:** Videos, Social media, Other - **Stats:** 12 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### Tiktok Video Details Scraper Pro Tiktok Video Details Scraper Pro is an Apify Actor designed to extract structured metadata and publicly available details from one or more TikTok video URLs. It accepts TikTok video links and returns a detailed dataset covering video information, creator details, engagement metrics, music metadata, media properties, timestamps, location metadata, content flags, and related URLs. The actor is useful for researchers, marketers, analysts, content teams, developers, and businesses that need structured TikTok video data without manually opening and recording information from individual video pages. Provide one or more supported TikTok video URLs, start the Actor, and review the resulting structured records in the Apify dataset. Each successfully processed video produces one result record. ### What Is a Tiktok Video Details Scraper? A Tiktok Video Details Scraper collects structured information associated with individual TikTok videos. Instead of manually checking a video page for its caption, creator, views, likes, comments, shares, music, dimensions, timestamps, and other metadata, this Actor organizes the available information into a consistent output record. The Actor is specifically oriented toward video URLs rather than general TikTok profile crawling. Users submit video links through the `startUrls` input, and the Actor processes those URLs individually. The returned data can support TikTok video research, content analysis, creator research, engagement analysis, dataset building, and other workflows that require organized video-level information. ### Key Features | Feature | Description | User Benefit | | ------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | TikTok video URL processing | Accepts one or more TikTok video URLs through `startUrls`. | Analyze multiple videos in a single run. | | Video metadata extraction | Returns video ID, caption, timestamps, duration, dimensions, URLs, and other metadata. | Creates structured video records for research and analysis. | | Engagement metrics | Provides formatted views, likes, comments, shares, saves, and calculated engagement rate. | Makes basic performance analysis easier. | | Creator information | Returns creator ID, username, profile URL, bio, verification status, and available audience statistics. | Connects video-level data with creator-level context. | | Music metadata | Includes music ID, title, artist, duration, cover, and available playback URL information. | Helps analyze the audio associated with a video. | | Media properties | Provides resolution, aspect ratio, orientation, format, codec, bitrate, file size, and media URLs when available. | Supports technical media analysis. | | Hashtags and mentions | Extracts detected hashtags and mentioned usernames from the video metadata. | Supports topic and creator-reference research. | | Content and permission flags | Includes duet, stitch, advertising, and other available flags. | Adds contextual information to each video record. | | Structured Apify dataset output | Each successful video is pushed as a structured result. | Makes the extracted data easier to review and use in downstream workflows. | ### What Data Can You Extract? The Actor returns a broad set of video-level and creator-level fields. The exact availability of individual values can depend on the information exposed for a particular TikTok video. **Video information** includes the full video URL, video ID, short/share URL, caption or description, hashtags, mentioned users, duration, upload date, upload time, Unix timestamp, resolution, aspect ratio, orientation, and content-related metadata. **Engagement information** includes view count, like count, comment count, share count, save or bookmark count, and a calculated engagement rate. Count values are formatted into readable representations such as `5k` or `2m`. **Creator information** includes creator user ID, username, profile URL, profile picture URL, bio, verified badge status, follower count, following count, total likes, and total videos when available. **Music information** includes music ID, title, artist name, original-sound status, music duration, cover image URL, music play URL, and audio download URL fields. **Media information** includes video file size, format, codec, bitrate, FPS field, video download URL, thumbnail URL, cover URL, and animated cover URL. Additional fields may include location metadata, video region or country, device-type information, duet and stitch information, transcript URL information, advertising status, NSFW/content flags, and other content indicators. Some output fields are intentionally represented as `N/A`, default values, or inferred values when the underlying video data does not directly provide a definitive value. ### Why Use the Tiktok Video Details Scraper? Manually collecting TikTok video metadata becomes repetitive when researching many individual videos. This Actor turns supported video URLs into structured records so users can review the information consistently. It can be useful when you need to compare videos, study creator activity, inspect engagement metrics, identify associated music, build research datasets, or organize media metadata for later analysis. Because the Actor accepts multiple `startUrls`, users can submit a collection of video URLs and process them within one run instead of recording every field manually. ### Benefits The main practical benefits come from structured extraction and repeatable processing. **Automation:** Reduce repetitive manual collection of video metadata. **Structured data:** Receive standardized fields that are easier to filter, inspect, and analyze. **Multiple URLs:** Submit one or more TikTok video URLs in a single run. **Research support:** Build datasets for content, creator, engagement, or media research. **Creator context:** Combine video performance information with available creator-level metadata. **Media analysis:** Review technical properties such as resolution, aspect ratio, format, bitrate, and file size. **Workflow flexibility:** Use the resulting Apify dataset as a structured source for subsequent analysis or processing. ### How to Use the Tiktok Video Details Scraper Using the Actor is straightforward: 1. Open the Actor in Apify. 2. Add one or more valid TikTok video URLs to **Start URLs**. 3. Review the configured inputs. 4. Start the Actor. 5. Wait for the processing to finish. 6. Open the resulting dataset and review the records. The `startUrls` input accepts entries containing a video URL. The Actor also supports string URL values when supplied programmatically according to its input handling. For initial testing, use a small number of URLs and verify that the returned records contain the information required for your workflow. ### Input The Actor has one required input field: | Field | Type | Required | Description | | ----------- | ----- | -------- | --------------------------------------------------- | | `startUrls` | Array | Yes | A list of one or more TikTok video URLs to process. | The input should contain TikTok video page URLs. The Actor processes the supplied URLs individually and attempts to create one structured output record for each successfully processed video. ### Input Example ```json { "startUrls": [ { "url": "https://www.tiktok.com/@byarvelor/video/7567310800646458657" }, { "url": "https://www.tiktok.com/@byarvelor/video/7537409698685898016" } ] } ``` For programmatic input, the Actor also recognizes string values inside the `startUrls` array. ### Output Each successfully processed TikTok video is returned as a structured dataset record. The output contains video, creator, engagement, music, media, location, and content-related fields. Values can vary between videos. Some fields may be `N/A`, empty, defaulted, or inferred when the corresponding information is not directly available. ### Output Fields | Field | Description | | ----------------------------------- | --------------------------------------------------------------------------- | | `Video URL` | Constructed TikTok video URL. | | `Video ID` | TikTok video identifier. | | `Short URL / Share URL` | Share-style URL generated for the video ID. | | `Video Caption / Description` | Video caption or description. | | `Caption Language` | Language field returned by the Actor; currently represented as `en`. | | `Hashtags` | Detected hashtag names. | | `Mentioned / Tagged Users` | Detected mentioned TikTok usernames. | | `Video Duration` | Video duration formatted as hours, minutes, and seconds. | | `Upload Date` | Upload timestamp represented as an ISO-formatted date/time value. | | `Upload Time` | Upload time formatted as `HH:MM:SS`. | | `Unix Timestamp` | Original creation timestamp in epoch format. | | `Video Resolution` | Video dimensions such as `1080x1920`. | | `Video Aspect Ratio` | Width-to-height representation. | | `Video Orientation` | Portrait or Landscape according to the extracted dimensions. | | `View Count` | Formatted video play count. | | `Like Count` | Formatted like count. | | `Comment Count` | Formatted comment count. | | `Share Count` | Formatted share count. | | `Save / Bookmark Count` | Formatted collection/bookmark count. | | `Engagement Rate` | Calculated interaction rate based on available engagement counts and plays. | | `Trending Status` | Boolean-style string based on the Actor's play-count threshold logic. | | `Music ID` | Associated music identifier when available. | | `Music Title` | Music title. | | `Music Author / Artist Name` | Music creator or artist name. | | `Original Sound Flag` | Indicates the returned original-sound value when available. | | `Music Duration` | Associated music duration. | | `Music Cover Image URL` | Music cover image URL. | | `Music Play URL` | Available music playback URL. | | `Audio Download URL` | Audio URL returned by the Actor. | | `Creator User ID` | Creator account identifier. | | `Creator Username` | Creator username with `@` prefix. | | `Creator Profile URL` | Creator's TikTok profile URL. | | `Creator Profile Picture URL` | Creator avatar URL. | | `Creator Bio` | Creator profile signature or bio. | | `Creator Verified Badge` | Creator verification status. | | `Creator Follower Count` | Formatted follower count. | | `Creator Following Count` | Formatted following count. | | `Creator Total Likes` | Formatted creator total-like value. | | `Creator Total Videos` | Formatted creator video count. | | `Video File Size` | Media size when available. | | `Video Format` | Video format, commonly represented as `mp4`. | | `Video Codec` | Codec information when available. | | `Video Bitrate` | Bitrate information when available. | | `Video FPS` | FPS field; currently may be `N/A`. | | `Video Download URL` | Available video media URL. | | `Thumbnail Image URL` | Video thumbnail URL. | | `Cover Image URL` | Original cover image URL. | | `Animated Cover URL` | Animated cover URL. | | `Location & Meta` | Available location-related metadata. | | `Video Region / Country` | Region associated with the video when available. | | `Device Type` | Device-type value generated by the Actor. | | `Is Duet Enabled` | Duet-related status. | | `Is Stitch Enabled` | Stitch-related status. | | `Duet Source Video ID` | Source video ID for duet metadata when available. | | `Stitch Source Video ID` | Source video ID for stitch metadata when available. | | `Remix Permission Flag` | Remix-related flag returned by the Actor. | | `Video Transcript (Speech-to-Text)` | Available subtitle/transcript URL information. | | `NSFW / Content Flag` | Content warning flag derived from available warning information. | | `Ad / Sponsored Flag` | Advertising status when available. | Additional output fields include content category, language code, application version, pinned-comment flag, spoken-language detection, OCR status, sentiment-analysis status, topic extraction status, AI caption summary, update time, content-risk flag, and copyright/music-restriction flag. Several of these fields may currently contain `N/A` or default values rather than analyzed results. ### Output Example ```json { "Video URL": "https://www.tiktok.com/@examplecreator/video/1234567890123456789", "Video ID": "1234567890123456789", "Short URL / Share URL": "https://vm.tiktok.com/1234567890123456789/", "Video Caption / Description": "Example TikTok video caption", "Caption Language": "en", "Hashtags": [ "example", "tiktok" ], "Mentioned / Tagged Users": [], "Video Duration": "00h, 00m, 15s", "Upload Date": "2026-01-15T12:30:00", "Upload Time": "12:30:00", "Unix Timestamp": 1768480200, "Video Resolution": "1080x1920", "Video Aspect Ratio": "1080:1920", "Video Orientation": "Portrait", "View Count": "125k", "Like Count": "8200", "Comment Count": "410", "Share Count": "950", "Save / Bookmark Count": "1200", "Engagement Rate": "8.61%", "Creator Username": "@examplecreator", "Creator Profile URL": "https://www.tiktok.com/@examplecreator", "Creator Verified Badge": false, "Video Format": "mp4", "Video Codec": "h264", "Video FPS": "N/A", "Thumbnail Image URL": "https://example.com/thumbnail.jpg", "NSFW / Content Flag": false, "Ad / Sponsored Flag": false } ``` ### Use Cases The Tiktok Video Details Scraper can support several practical workflows: **TikTok content research:** Collect captions, hashtags, timestamps, engagement counts, and media metadata for selected videos. **Creator research:** Connect individual videos with available creator profile statistics. **Engagement analysis:** Compare views, likes, comments, shares, saves, and the calculated engagement rate across collected records. **Content strategy research:** Examine recurring hashtags, music information, video formats, and creator activity. **Dataset creation:** Build structured datasets from a collection of TikTok video URLs for later analysis. **Media metadata research:** Study dimensions, aspect ratios, formats, codecs, bitrates, file sizes, covers, and available media URLs. ### Advantages The Actor combines video-level metadata, creator context, engagement measurements, music information, and media properties in a single structured record. This can be useful when a workflow requires more than just a video URL or caption. It also accepts multiple start URLs, which is useful for batch-oriented research where a set of known TikTok video links needs to be processed together. ### Limitations Results depend on the information available for each TikTok video and the data exposed on the source page at processing time. Some fields are not independently analyzed by the Actor and may appear as `N/A`, default values, or inferred values. In particular, OCR, sentiment analysis, topic extraction, AI caption summaries, spoken-language detection, and some other advanced fields are not populated with external AI analysis. The transcript field represents available subtitle URL information rather than a generated speech-to-text transcript. Certain flags and classifications are also derived from available metadata or predefined Actor logic and should be interpreted accordingly. A failed or unavailable source page may result in no dataset record for that URL. ### Pros and Cons | Pros | Cons | | --------------------------------------------------- | ---------------------------------------------------------------- | | Supports multiple TikTok video URLs in one run. | Individual fields may be unavailable for some videos. | | Produces structured video and creator metadata. | Some advanced analysis fields remain `N/A`. | | Includes engagement, music, and media information. | Certain values are inferred or generated using predefined logic. | | Useful for organized research and dataset creation. | Failed source retrieval can result in a missing record. | ### Comparison With Alternative Approaches | Capability | This Actor | Manual / Typical Alternative | | ------------------------ | ----------------------------------------------------- | ------------------------------------------------- | | Multiple video inputs | Supported through `startUrls`. | Often requires checking videos individually. | | Structured video records | Supported. | May require manual copying and formatting. | | Creator metadata | Included where available. | Usually collected separately. | | Engagement metrics | Included in the output record. | Requires manual recording or separate processing. | | Media metadata | Included where available. | May require additional inspection. | | Repeatable workflow | Same documented input/output structure can be reused. | Manual workflows can be more repetitive. | ### Best Practices Start with a small test set before processing a large collection of video URLs. This lets you confirm that the source videos are accessible and that the returned fields meet your requirements. Use valid TikTok video URLs and keep the `startUrls` structure consistent with the documented input schema. Review important metrics before making analytical decisions. Formatted counts and calculated engagement rates are designed for convenient structured output, but users should consider the context and timing of the underlying source data. For research datasets, retain the original video URL and video ID alongside derived metrics so individual records remain easy to identify. Treat inferred, defaulted, or `N/A` values differently from directly available source metadata when performing downstream analysis. ### Troubleshooting **Invalid Input:** Check that `startUrls` is an array and that each entry contains a valid TikTok video URL. **Empty Results:** Verify the URL, confirm that the video is accessible, and test with another supported TikTok video URL. **Partial Results:** Individual videos can return different amounts of information. Review the specific output record and distinguish unavailable fields from successfully extracted values. **Missing Fields:** Some source pages may not expose every metadata property. Fields such as advanced language, OCR, sentiment, or topic analysis may intentionally remain `N/A`. **Failed Processing:** A source request may fail or the expected page data may not be available. Testing the URL again later or using another accessible video can help determine whether the issue is temporary or specific to that source. ### Frequently Asked Questions **What does the Tiktok Video Details Scraper Pro do?** It extracts structured metadata and available public details from TikTok video URLs and stores each successful result as an Apify dataset record. **What input does the Actor require?** The required input is `startUrls`, an array containing one or more TikTok video URLs. **Can I process multiple TikTok videos?** Yes. Multiple TikTok video URLs can be supplied through the `startUrls` array in the same Actor run. **What data does a TikTok video scraper return?** The output can include video metadata, captions, hashtags, mentions, engagement metrics, creator information, music metadata, media properties, timestamps, location metadata, and content-related flags. **Does it return creator information too?** Yes. When available, the output includes creator ID, username, profile URL, profile picture URL, bio, verification status, and creator statistics. **Does the Actor calculate engagement rate?** Yes. The Actor calculates an engagement rate from available likes, comments, shares, saves, and play count values when the play count is greater than zero. **Does it provide video and audio URLs?** The output includes available video and music playback/download URL fields when those values are present in the source metadata. **Does it generate a full transcript?** No. The transcript field represents available subtitle URL information. It does not indicate that a new speech-to-text transcript has been generated by an external AI service. **Why do some fields contain `N/A`?** Some information may not be available for a particular video, while several advanced fields are not independently analyzed by the Actor. **Can I use the output for research or analytics?** Yes. The structured dataset can be useful for content research, creator research, engagement analysis, media metadata analysis, and dataset creation. **What should I do if a video returns no result?** Verify that the URL is correct and accessible, then test another TikTok video URL. A source that cannot be successfully processed may not produce a dataset record. ### NLP Keywords - TikTok video metadata - TikTok video data extraction - TikTok video scraper - TikTok video details - TikTok video analytics - TikTok engagement metrics - TikTok creator data - TikTok video statistics - TikTok video information - TikTok content metadata - TikTok video URL scraper - TikTok music metadata - TikTok hashtag extraction - TikTok mention extraction - TikTok media metadata - TikTok creator profile data - TikTok video research - TikTok structured data - TikTok dataset extraction - TikTok content research ### Related Keywords - TikTok video scraper online - extract TikTok video data - scrape TikTok video details - TikTok video metadata extractor - TikTok video information scraper - TikTok URL data extractor - TikTok video analytics data - TikTok video engagement data - TikTok creator information extractor - TikTok video statistics scraper - TikTok video caption extractor - TikTok hashtag data extractor - TikTok music information scraper - TikTok video media metadata - TikTok video dataset - TikTok content data extraction - TikTok video research tool - TikTok video profile metadata - extract TikTok creator data - TikTok structured video data ### Final Overview Tiktok Video Details Scraper Pro provides a structured way to collect information from one or more TikTok video URLs. Its output combines video metadata, engagement metrics, creator information, music details, media properties, timestamps, and additional content-related fields in a consistent dataset format. The Actor is designed for users who already have TikTok video URLs and need organized records for research, analysis, content workflows, or dataset creation. Start with a small group of valid URLs, review the results, and then incorporate the structured data into your broader workflow. **Contact me:** # Actor input Schema ## `startUrls` (type: `array`): List of one or more tiktok video URLs ## Actor input object example ```json { "startUrls": [ { "url": "https://www.tiktok.com/@byarvelor/video/7567310800646458657" }, { "url": "https://www.tiktok.com/@byarvelor/video/7537409698685898016" } ] } ``` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.tiktok.com/@byarvelor/video/7567310800646458657" }, { "url": "https://www.tiktok.com/@byarvelor/video/7537409698685898016" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("alpha-scraper/tiktok-video-details-scraper-pro").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 = { "startUrls": [ { "url": "https://www.tiktok.com/@byarvelor/video/7567310800646458657" }, { "url": "https://www.tiktok.com/@byarvelor/video/7537409698685898016" }, ] } # Run the Actor and wait for it to finish run = client.actor("alpha-scraper/tiktok-video-details-scraper-pro").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.tiktok.com/@byarvelor/video/7567310800646458657" }, { "url": "https://www.tiktok.com/@byarvelor/video/7537409698685898016" } ] }' | apify call alpha-scraper/tiktok-video-details-scraper-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,alpha-scraper/tiktok-video-details-scraper-pro" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/kZMMAHBehLOdG2FBb/builds/blsZuCFRHSbe9C6KK/openapi.json