Positioning and field coverage align with tools in the broader ecosystem. For external product context and typical fields, see: Apify TikTok Scraper.

✨ Features

• ✅ Video detail: caption text, timestamp, author info, engagement stats (likes/comments/favorites/shares), music name, cover, hashtags (when available)
• ✅ Hashtag page: first-screen items (configurable via maxItems) and best-effort hashtag views
• ✅ Profile page: tab switching (Videos/Reposts/Liked), first-screen items, and best-effort author avatar/nickname/signature
• ✅ Multiple formats: Markdown + JSON, plus a full-page screenshot (screenshot@fullPage)

💲 Pricing

Cost: 1 credits per call (see pricing.perCall in template.json)

Engine: Playwright. Extraction runs after a fixed delay for reliability.

🌐 Supported URLs

• https://www.tiktok.com/@USER/video/VIDEO_ID
• https://www.tiktok.com/tag/TAG_NAME
• https://www.tiktok.com/@USER

Notes:

• Video detail returns a single item (wrapped in an array).
• Hashtag and Profile return the currently visible first-screen items only (no autoscroll, no pagination).

🧩 Inputs

• url (required): TikTok page URL (video detail / hashtag / profile)
• variables.waitFor (optional, default 500): extra wait in milliseconds before extraction
• variables.timeoutMs (optional, default 35000): page load and selector wait timeout in milliseconds
• variables.maxItems (optional, default 30): maximum number of items to collect on list pages
• variables.profileSection (optional, default videos): profile tab, enum: videos | reposts | liked

Example inputs (JSON)

Video detail:

{
  "url": "https://www.tiktok.com/@USER/video/7298624334447299858",
  "variables": {
    "waitFor": 800,
    "timeoutMs": 35000
  }
}

Hashtag page:

{
  "url": "https://www.tiktok.com/tag/bananas",
  "variables": {
    "maxItems": 20
  }
}

Profile (Reposts tab):

{
  "url": "https://www.tiktok.com/@funnyanimation242",
  "variables": {
    "profileSection": "reposts",
    "maxItems": 24
  }
}

📦 Outputs

This template produces:

• 📄 Markdown: a readable view of key fields (title/author/time/stats, etc.)
• 🧾 JSON (under the "JSON Result" tab): fields appear only when derivable
• 🖼️ Screenshot: a full-page screenshot (screenshot@fullPage)

JSON fields (when available)

• Common video item: id, text, createTimeISO, webVideoUrl, hashtags, diggCount (likes), commentCount, collectCount (favorites), shareCount
• authorMeta: name, profileUrl, nickName, avatar, signature (best‑effort)
• musicMeta: musicName (other music fields best‑effort)
• videoMeta: coverUrl, format, etc. (best‑effort)
• Hashtag page addition: searchHashtag (e.g., { name, views }) describing the current hashtag and its views (best‑effort)

Video detail JSON example (fragment)

[
  {
    "id": "7298624334447299858",
    "webVideoUrl": "https://www.tiktok.com/@funnyanimation242/video/7298624334447299858",
    "text": "banana bananana ...",
    "createTimeISO": "2023-11-07T07:50:05.000Z",
    "diggCount": 18400,
    "shareCount": 1902,
    "commentCount": 257,
    "collectCount": 1912,
    "musicMeta": { "musicName": "original sound" },
    "authorMeta": {
      "name": "funnyanimation242",
      "profileUrl": "https://www.tiktok.com/@funnyanimation242",
      "avatar": "https://.../avatar.jpg"
    },
    "hashtags": [{ "name": "bananas" }]
  }
]

Hashtag page JSON example (fragment)

[
  {
    "id": "7298624334447299858",
    "webVideoUrl": "https://www.tiktok.com/@user/video/7298624334447299858",
    "text": "...",
    "diggCount": 123,
    "hashtags": [{ "name": "bananas" }],
    "searchHashtag": { "name": "bananas", "views": 722300 }
  }
]

Note: list pages include only first-screen items; scrolled-in content is not captured.

⚙️ Configuration notes

• waitFor: fixed delay after navigation; increasing it can help with dynamic rendering
• timeoutMs: overall timeout for page load and selector waits
• maxItems: maximum items collected on list pages
• profileSection: profile tab selection (videos / reposts / liked)

📝 Notes & limitations

• Public content only; private/protected/age- or region-restricted pages may be limited or missing fields
• No autoscroll or pagination; only first-screen items are returned
• TikTok UI/DOM changes can affect parsing; increase waitFor or adjust selectors if needed
• Engagement stats are best‑effort from rendered values and may be formatted; missing fields are omitted
• No video file download; only basic metadata and cover URL when available

🔧 Troubleshooting

• Empty content or missing fields: increase waitFor; ensure the URL is publicly accessible; check for DOM changes
• No items on hashtag/profile: confirm the page is not geo/age restricted or behind a login wall; try lowering maxItems or increasing wait

⚖️ Compliance & legal

Ensure your use complies with TikTok’s Terms of Service and applicable laws (e.g., GDPR). If unsure, consult legal counsel. See also Apify’s guidance on legal and ethical scraping: Apify TikTok Scraper.

🗓️ Version history

• v1.0.0 (2025‑10‑12): Initial release. Supports video detail, hashtag, and profile (Videos/Reposts/Liked) first-screen extraction; Markdown/JSON/full-page screenshot outputs; fixed wait for stability.