TikTok post scraper in n8n
Fetch full metadata for any TikTok video or photo-carousel post by URL or ID: engagement stats, author snapshot, music details, hashtags, mentions, and signed media URLs.
What this workflow does
Import it and n8n runs the TikTok Post & Slideshow Detail Scraper Actor on Apify every day at 08:00 with the starter input below. Each row comes back with post id, post url, type, caption and 19 more; repeats with the same postUrl are dropped. A Google Sheets append is included and stays off until you add your sheet. The only credential it needs is your Apify API token.
Read from the workflow file, built for TikTok Post & Slideshow Detail Scraper version 2.0.1. Updated 2026-11-14.How the rows travel
6 nodes, in the order n8n runs them. The yellow stop is the call to the Apify Actor; the dashed stop is optional.
- Daily trigger Schedule trigger
- Configure input Code
- Run Apify Actor HTTP Request
- Normalize + dedupe Code
- Rows ready No operation
- Google Sheets (optional) Google Sheets, off until you switch it on
From the Short
This workflow is the one the video points to: the number in each video opens this page.
Input
The Configure input node holds the starter input. Change it there; every setting the Actor accepts is listed below.
{
"postUrls": [
"https://www.tiktok.com/@khaby.lame/video/7574844184952081686"
],
"maxItems": 25,
"maxDetail": 1,
"maxCommentsPerPost": 25
}| Setting | Type | Required | Default | What it does |
|---|---|---|---|---|
| mode | string | No | posts | What to scrape: individual posts, a profile's newest posts, or comment threads on posts. One of: posts, profiles, comments. |
| postUrls | array | No | – | TikTok video/photo URLs, /v/ share links, embed links, vm.tiktok.com or vt.tiktok.com short links, or bare numeric post IDs. Duplicates are scraped once. |
| postIds | array | No | – | Numeric TikTok post IDs (15-20 digits). Use this instead of, or in addition to, postUrls. |
| profiles | array | No | – | TikTok usernames (@handle), profile URLs, or bare handles. Profiles mode returns up to 500 newest posts per profile; comments mode can use them as comment targets. |
| maxItems | integer | No | 100 | Global cap on output rows. Posts mode counts posts; profiles mode counts posts; comments mode counts comments and replies. Status rows do not count. |
| maxDetail | integer | No | 50 | How many posts get the slower page/detail enrichment (caption language, collect/repost counts, video tracks). Remaining posts use the fast embed record. |
| maxCommentsPerPost | integer | No | 100 | Maximum comments plus replies to keep for each post in comments mode, or to attach to each post when Include comments is on. |
| includeReplies | boolean | No | false | Fetch the reply thread under each root comment and include replies with their parent. |
| includeComments | boolean | No | false | In posts/profiles mode, attach a comments array to each post. In comments mode, emit root comment rows (comments mode enables this automatically when both comment toggles are off). |
| proxyConfiguration | object | No | – | Optional. Leave empty to run directly; a proxy is not required. The actor falls back to an Apify datacenter proxy on a block signal. |
| includeMediaUrls | boolean | No | true | Include signed video, cover, music, and slideshow image URLs plus mediaUrlExpiresAt. They typically expire in about 48 hours. |
| validateMediaUrls | boolean | No | false | Check the main media URL with a GET Range request (TikTok's CDN rejects HEAD) and add mediaUrlAccessible. Adds latency. |
| includeAuthorStats | boolean | No | true | Include follower, following, heart, and video counts in author and authorStats. |
| includeHashtags | boolean | No | true | Include the hashtags array extracted from the caption. |
| includeMentions | boolean | No | true | Include the mentions array extracted from the caption with text offsets. |
| includeSubtitles | boolean | No | false | Include video.subtitleInfos, video.bitrateInfo, and video.volumeInfo (detail path only). |
| includeRawFields | boolean | No | false | Include item_control, contents, effectStickers, and stickersOnItem from the detail payload. Legacy includeEffectStickers/includeItemControl/includeContents inputs map here. |
What each row holds
Every field the Actor returns stays in the row (23 in its dataset schema). Normalize + dedupe trims text, drops empty fields, removes repeats with the same postUrl and adds _source and _scrapedAt. The main fields:
| Field | What it is |
|---|---|
| postId | Post ID |
| postUrl | Post URL |
| postType | Type |
| caption | Caption |
| createdAt | Created At |
| playCount | Plays |
| likeCount | Likes |
| commentCount | Comments |
| shareCount | Shares |
| author | Author |
| source | Source |
What the first run costs
With the starter input (maxItems = 25) a first run costs about $0.42 on the Apify Free plan: $0.40 to start the run at 4 GB of memory and $0.02 for the results, plus platform usage.
The Actor lists $0.99 per 1,000 results; its catalogue page breaks the price down by Apify plan. The Apify Free plan includes $5 of usage a month.
The Actor behind it
TikTok Post & Slideshow Detail Scraper: Fetch full metadata for any TikTok video or photo-carousel post by URL or ID: engagement stats, author snapshot, music details, hashtags, mentions, and signed media URLs.
The same job from an AI agent
The matching agent skill gives Claude Code, Codex, Cursor and other agents the same Actor, input and fields. Install it in one line:
npx skills add https://scraperfinder.com --skill tiktok-post-and-slideshow-detail-scraper The tikTok post scraper skill, with manual install and run steps
Questions people ask
How do I import this workflow into n8n?
Copy https://scraperfinder.com/n8n/tiktok-post-and-slideshow-detail-scraper.json. In n8n, open a new workflow, click the three-dot menu, choose Import from URL and paste it. Or download the JSON file and use Import from File; both give the same 6 nodes.
Do I need an Apify account?
Yes. The workflow calls the TikTok Post & Slideshow Detail Scraper Actor through the Apify API with your own token, and each run is billed to your Apify account. The Free plan includes $5 of usage a month.
What does a run cost?
With the starter input (maxItems = 25) a first run costs about $0.42 on the Apify Free plan: $0.40 to start the run at 4 GB of memory and $0.02 for the results, plus platform usage. The Actor's Store page shows the current price.
Can I change what it collects?
Yes: edit the input object in the Configure input node. The Actor takes 17 settings; the table on this page lists each one with its default. Raise maxItems once the first rows look right.
Does it work without Google Sheets?
Yes. The rows wait in the Rows ready node, so you can connect any other node there: a database, Airtable, a webhook or an email. The Google Sheets node is only one option.
Workflow updated 2026-11-14