TikTok Profile Scraper – Extract Posts, Stats, Videos & Music

TikTok Profile Scraper creates a structured dataset of posts collected from public TikTok profiles. Each dataset item represents one post and can include video and CDN URLs, engagement stats (likes, comments, shares, views, saves), music metadata, hashtags, tagged users, author profile information, and post creation timestamps. Query the source by profile URL or handle, control the result limit with maxPosts, and retrieve records through the Apify Dataset API or export them as JSON, CSV, Excel, or XML.

Dataset at a glance

Property	Value
Source	tiktok.com (public profiles)
Record unit	One post (video or image/slideshow)
Input methods	Profile URLs or handles (profileUrls)
Main identifiers	id (post ID), url
Delivery	Apify Dataset and API
Export formats	JSON, CSV, Excel, XML
Update model	Fresh records per Actor run
Pricing	$5 per 1,000 posts

Coverage and available records

The Actor collects all posts from one or more public TikTok profiles.

• Profile input: profileUrls accepts any profile link format (https://www.tiktok.com/@fcbarcelona, https://m.tiktok.com/@narins.beauty_, or just @username).
• Multiple profiles: Provide several profiles in one run; posts are collected per profile up to the maxPosts limit.
• Post types: Video posts and image/slideshow posts are both supported. Image posts return an images array; video posts return a video object.
• Result limit: maxPosts caps the number of posts per profile (0 = unlimited).
• Enrichment: Each post includes engagement stats, music metadata, hashtags, tagged users, and the author's profile metadata.

Known exclusions: only public profiles are collected; private or age-restricted profiles that require login are not accessible; each run captures profile state at run time (no historical snapshots).

Data dictionary

Field names below match dataset record JSON properties exactly.

Field	Type	Nullable	Description	Example
id	string	No	TikTok post identifier; best stable deduplication key	7639302892674944278
url	string	No	Canonical post URL	https://www.tiktok.com/@fcbarcelona/video/7639302892674944278
description	string	Yes	Post caption with hashtags and mentions	#fcbarcelona #barçaontiktok
createdAt	integer	Yes	Unix timestamp of post creation	1778663821
createdAtISO	string	Yes	ISO 8601 datetime of post creation	2026-05-12T19:57:01+00:00
isImagePost	boolean	Yes	Whether the post is a photo/slideshow rather than video	false
isAd	boolean	Yes	Whether the post is a paid advertisement	false
isReviewing	boolean	Yes	Whether the post is under review	false
diversificationId	integer	Yes	TikTok content diversification category ID	0
categoryType	integer	Yes	TikTok content category type	0
aiGeneratedDescription	string	Yes	AI-generated description when present	—
images	array	Yes	Image URLs for slideshow/photo posts	["https://..."]
hashtags	array	Yes	Hashtag objects {id, title, description}	See example record
taggedUsers	array	Yes	Users tagged in the caption	[]
effectStickers	array	Yes	Effect stickers applied to the post	[]
contents	array	Yes	Structured caption segments with text extras	[]
video	object	Yes	Video metadata: {duration, cover, dynamicCover, playUrl, downloadUrl, bestQualityUrl, width, height, ratio}	See example record
stats	object	Yes	Engagement: {diggCount, shareCount, commentCount, playCount, collectCount}	See example record
music	object	Yes	Music metadata: {id, title, authorName, duration, playUrl, coverLarge, isOriginal}	See example record
authorMeta	object	Yes	Author profile: {id, uniqueId, nickname, verified, avatar, signature, followerCount, followingCount, heartCount, videoCount}	See example record
itemControl	object	Yes	{canRepost, canDuet, canStitch} permissions	See example record

Example dataset record

A representative record produced by scraping @fcbarcelona:

{
  "id": "7639302892674944278",
  "url": "https://www.tiktok.com/@fcbarcelona/video/7639302892674944278",
  "description": "#fcbarcelona #barçaontiktok",
  "createdAt": 1778663821,
  "createdAtISO": "2026-05-12T19:57:01+00:00",
  "isImagePost": false,
  "hashtags": [
    { "id": "26656", "title": "fcbarcelona", "description": "" }
  ],
  "taggedUsers": [],
  "video": {
    "duration": 30,
    "cover": "https://p16-common-sign.tiktokcdn-eu.com/...",
    "playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/...",
    "downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/...",
    "bestQualityUrl": "https://v16-webapp-prime.tiktok.com/video/tos/...",
    "width": 1080,
    "height": 1920,
    "ratio": "9:16"
  },
  "stats": {
    "diggCount": 26200,
    "shareCount": 141,
    "commentCount": 364,
    "playCount": 149800,
    "collectCount": 847
  },
  "music": {
    "id": "7420525641043855361",
    "title": "New Skills",
    "authorName": "Prodbyecho",
    "duration": 59,
    "playUrl": "https://sf16-ies-music-sg.tiktokcdn.com/...",
    "isOriginal": false
  },
  "authorMeta": {
    "id": "6594121926820872197",
    "uniqueId": "fcbarcelona",
    "nickname": "FC Barcelona",
    "verified": true,
    "signature": "Get the OR jersey",
    "followerCount": 66800000,
    "followingCount": 31,
    "heartCount": 2700000000,
    "videoCount": 5681
  },
  "itemControl": { "canRepost": true, "canDuet": true, "canStitch": true }
}

Query and input reference

Input	Type	Required	Default	Accepted values	Description
profileUrls	array	Yes	—	TikTok profile URLs or handles	Profiles to scrape (any link format or @username)
maxPosts	integer	No	0	0 or a positive integer	Maximum posts per profile; 0 = unlimited
proxy	object	No	Apify residential proxy	Apify proxy groups or custom proxies	Residential proxies are recommended

Minimal request:

{ "profileUrls": [{ "url": "https://www.tiktok.com/@fcbarcelona" }] }

Advanced request:

{
  "profileUrls": [
    { "url": "https://www.tiktok.com/@fcbarcelona" },
    { "url": "https://www.tiktok.com/@narins.beauty_" }
  ],
  "maxPosts": 100,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

Retrieve the data through the API

1. Start the Actor with a JSON input (console or API).
2. Wait for the run to finish, or use a synchronous endpoint for an inline response.
3. Retrieve items from the run's default dataset.
4. Paginate or export the dataset.

Python example:

from apify_client import ApifyClient

client = ApifyClient("YOUR-APIFY-TOKEN")

run = client.actor("datascrapers/tiktok-profile-scraper").call(run_input={
    "profileUrls": [{ "url": "https://www.tiktok.com/@fcbarcelona" }],
    "maxPosts": 100,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["id"], item["stats"]["diggCount"])

Apify generates ready-to-run Python, JavaScript, and cURL examples on the Actor's API tab. Do not put a real API token in shared code or URLs.

Data quality and record handling

• Conditional fields: Image posts omit the video object; video posts omit the images array. Fields that TikTok does not expose for a post are returned as null.
• Source changes: TikTok page structure and values can change; unreadable fields are returned as null rather than fabricated.
• Deduplication: Each run appends fresh records; the Actor does not deduplicate across runs. Use id as the stable key and filter repeated runs against previously stored IDs.
• Rate limits: TikTok rate-limits automated traffic. Residential proxies (enabled by default) are recommended for consistent coverage, especially at scale.
• Normalization: Creation time is returned as both a Unix timestamp (createdAt) and ISO 8601 (createdAtISO); engagement counts are read as integers.

Export and pipeline examples

Destination	Recommended method	Typical use
PostgreSQL / Supabase	Dataset API poll or webhook consumer	Store post and engagement history for dashboards
Google Sheets	Apify Google Sheets integration	Share influencer post lists with teams
S3 / cloud storage	Scheduled export via Apify scheduler	Archival of content snapshots
BI tools	CSV / JSON export	Influencer and content trend analysis

Pricing and cost examples

The Actor uses pay-per-event pricing, billed per post record:

Event	Trigger	Rate
Posts	Every post pushed to the dataset	$5 per 1,000 posts

A one-time Actor start event of $0.00005 applies to each run (effectively $0).

Posts	Estimated base cost
1,000	$5.00
10,000	$50.00
100,000	$500.00

Compute units consumed by the run are billed by your Apify plan. Estimates depend on the verified pricing model and the options selected for the run.

Limitations and responsible data use

• The Actor collects publicly accessible post data from public TikTok profiles only.
• Field availability depends on what TikTok renders at run time; some values can be null or missing, and site changes can alter fields.
• The Actor does not provide historical snapshots unless you store them yourself.
• Large runs require residential proxies; without them, coverage may degrade due to rate limiting.
• You are responsible for compliance with TikTok's terms of service, applicable privacy law, and any contractual obligations before using the data.

Dataset questions

What does one dataset item represent?

One TikTok post. All engagement, music, hashtag, and author metadata is nested inside that single post record.

Which field should I use as a unique identifier?

id is the stable TikTok post identifier and the recommended deduplication key. url is a reasonable secondary key.

Are fields nullable or conditional?

Yes. Image posts omit the video object and video posts omit the images array. Fields TikTok does not expose for a given post are returned as null.

Can I retrieve the records as CSV or JSON?

Yes. The dataset can be exported as JSON, CSV, Excel, or XML from the Apify Console, and queried through the Dataset API.

Does the Actor return historical data?

No. Each run captures the state of the profiles at run time. To track changes, schedule repeated runs and store the outputs yourself.

What counts as a billable result?

Each post pushed to the dataset is one billable result, charged at $5 per 1,000 posts. Use maxPosts to control cost per run.

Related datasets from Data Scrapers

• Instagram Post Scraper — Public Instagram posts for cross-platform influencer research.
• Twitter X Profile Scraper — Profile and post data from X for social monitoring.
• YouTube Channel Scraper — Channel metadata and video data for content research.
• LinkedIn Profile Scraper — Professional profile data for creator and audience analysis.

Data Scrapers support

Need an additional field, record type, or export workflow? Contact Data Scrapers at stardustspotlight@gmail.com. Include a sample source URL, required fields, expected record volume, and preferred delivery format.