TikTok Social Share Preview Scraper

The TikTok Social Share Preview Scraper extracts link preview card metadata from public TikTok URLs — the same Open Graph and Twitter card fields that Slack, Discord, iMessage, LinkedIn, and Facebook show when someone pastes a TikTok link. Paste video, profile, hashtag, or music URLs and get structured JSON with title, description, thumbnail image, and embed URL.

No TikTok login is required. The Actor emulates a link-preview crawler user-agent (Facebook by default) and reads the public meta tags TikTok serves to messaging apps.

---

What does TikTok Social Share Preview Scraper do?

Most TikTok scrapers return engagement stats, comments, or transcripts. This Actor focuses on a different job — what the link looks like when shared:

• Reads public TikTok pages with a link-preview bot user-agent
• Returns og:title, og:description, og:image, and canonical og:url
• Includes Twitter card fields and TikTok embed iframe URL when present
• Works on videos, profiles, hashtags, and music pages
• Accepts short vm.tiktok.com / vt.tiktok.com links (redirects followed)
• Exports JSON, CSV, Excel, or API rows for CMS, chatbots, and marketing tools

---

What data can you extract?

Field	Description
url	Canonical TikTok URL from og:url
inputUrl	URL you provided in the input
contentType	video, profile, hashtag, music, or unknown
videoId	Numeric video id when the URL is a video
username	Creator handle when available
title	Share card title — for videos: {author} on TikTok (matches Slack/iMessage cards)
description	Share card description — for videos: the caption from TikTok oEmbed
caption	Video caption (same as description for video URLs)
authorName	Creator display name
authorUrl	Creator profile URL
ogTitle	Raw og:title from link-preview HTML
ogDescription	Raw og:description from link-preview HTML
imageUrl	Preview thumbnail (og:image)
siteName	Usually TikTok
twitterTitle	Twitter card title
twitterDescription	Twitter card description
twitterImage	Twitter card image
iframeUrl	TikTok embed player URL when present
iconUrl	TikTok brand icon from Lark meta tags
brandName	Brand label (usually TikTok)
previewBot	Bot user-agent used (facebook, twitter, etc.)
isGenericFallback	true when TikTok returned a generic placeholder (often deleted/private videos)
scrapedAt	ISO timestamp

---

Why scrape TikTok share previews?

1. CMS / link unfurling — show the same preview card in your app that Slack or Discord would
2. Marketing QA — verify how a campaign link renders before launch
3. Influencer outreach — batch-check how profile and video links appear in DMs
4. Hashtag monitoring — capture how #fyp and branded tags preview in chat apps
5. Competitive research — compare preview thumbnails and titles across creators
6. Chatbot enrichment — attach title + image when a user drops a TikTok URL
7. Archive / audit — store what the public preview looked like on a given date
8. No heavy browser — fast HTTP extraction without Playwright overhead

---

How to scrape TikTok share previews

1. Open the Actor in Apify Console
2. Paste one or more public TikTok URLs (video, profile, hashtag, or music)
3. Leave Preview bot on facebook (recommended)
4. Click Start
5. Download results from the Output tab (JSON, CSV, Excel, or API)

You can also call the Actor from the Apify API, a schedule, or a webhook.

---

Input

Field	Required	Default	Description
startUrls / tiktokUrls	yes*	—	Public TikTok URLs
previewBot	no	facebook	Link-preview bot to emulate (facebook, twitter, discord, slack, linkedin)
maxItems	no	1	Max preview rows per input URL
proxyConfiguration	no	No proxy	Enable only if TikTok is blocked in your region

*Provide at least one URL in startUrls or tiktokUrls.

Example input

{
  "startUrls": [
    { "url": "https://www.tiktok.com/@khaby.lame/video/7631024397754600735" },
    { "url": "https://www.tiktok.com/@khaby.lame" },
    { "url": "https://www.tiktok.com/tag/fyp" }
  ],
  "previewBot": "facebook",
  "maxItems": 1,
  "proxyConfiguration": { "useApifyProxy": false }
}

---

Output example

{
  "inputUrl": "https://www.tiktok.com/@khaby.lame",
  "url": "https://www.tiktok.com/@khaby.lame",
  "contentType": "profile",
  "videoId": null,
  "username": "khaby.lame",
  "title": "Khabane lame on TikTok",
  "description": "@khaby.lame 163.0m Followers, 81 Following, 2680.9m Likes - Watch awesome short videos created by Khabane lame",
  "imageUrl": "https://p16-common-sign.tiktokcdn-us.com/...jpeg",
  "siteName": "TikTok",
  "ogType": "website",
  "twitterTitle": "Khabane lame on TikTok",
  "twitterDescription": "@khaby.lame 163.0m Followers, 81 Following, 2680.9m Likes - Watch awesome short videos created by Khabane lame",
  "twitterImage": "https://p16-common-sign.tiktokcdn-us.com/...jpeg",
  "brandName": "TikTok",
  "iconUrl": "https://lf16-tiktok-common.ibytedtos.com/obj/tiktok-web-common-sg/mtact/static/images/tiktok-logo/logo.png",
  "iframeUrl": null,
  "previewBot": "facebook",
  "isGenericFallback": false,
  "scrapedAt": "2026-09-24T12:00:00.000Z"
}

---

Notes

• Share preview ≠ full video metadata. This Actor returns what link unfurlers see — not likes, comments, or transcripts. Use TikTok Scraper for full video stats.
• Video captions: TikTok’s link-preview HTML often serves a generic og:description (TikTok | Make Your Day). For video URLs the Actor also calls TikTok’s public oEmbed API so title and description match Slack, Discord, and iMessage cards (e.g. x0tkin on TikTok + the real caption).
• isGenericFallback: When true, TikTok returned the generic “Visit TikTok to discover videos!” card — often for deleted, private, or invalid video ids.
• Bot user-agent matters: TikTok serves Open Graph tags to link-preview crawlers. The default facebook bot works reliably; other bots may return sparser HTML.
• Proxies: Usually not needed. Enable Apify Proxy only if TikTok is geo-blocked in your region.

---

How much does it cost?

Pay-per-event pricing on the Apify platform (platform usage included):

Event	Price
Actor start	$0.00005
Share preview (per TikTok URL)	from $0.00149 (GOLD) / $0.00199 (FREE)

Example: 1,000 TikTok link previews on the FREE tier ≈ $1.99 plus the actor start fee. No proxy required for most runs.

---

Integrations

Use the Apify API, webhooks, schedules, or integrations with Zapier, Make, and Google Sheets to automate preview checks whenever new TikTok URLs are added to a spreadsheet or CRM.

---

Image Credit

Image credit: TikTok