TikTok User Posts Scraper

List public videos from a TikTok profile with captions and engagement counts. Set a public TikTok username and continue with the cursor when another page is available.

What data can you extract?

Captions, profile details and engagement counts reflect public TikTok pages; counts can be hidden or absent.

Field	Type	Description
desc	text	Video caption from TikTok for this TikTok video; null when the source has no text to show.
author	object	Creator profile with ID, username, display name, avatar and follower count from TikTok; null when the source provides no details.
digg_count	number	Number of likes shown by TikTok, as a whole number; zero is possible, and null means no count was reported.
comment_count	number	Number of comments shown by TikTok, as a whole number; zero is possible, and null means no count was reported.
share_count	number	Number of shares shown by TikTok, as a whole number; zero is possible, and null means no count was reported.
play_count	number	Number of video plays shown by TikTok, as a whole number; zero is possible, and null means no count was reported.
create_time	number	Creation timestamp for this TikTok video, as a Unix timestamp in seconds; null if TikTok does not supply it.
aweme_id	text	TikTok video ID for the TikTok video, assigned by TikTok; null when the source does not expose it.
lookup_unique_id	text	lookup unique id for the TikTok video, assigned by TikTok; null when the source does not expose it.
lookup_user_id	text	lookup user id for the TikTok video, assigned by TikTok; null when the source does not expose it.

Use cases

• Social researchers can discover TikTok videos matching a phrase or creator.
• Creators can compare captions and engagement before choosing a topic.
• Campaign teams can monitor posts linked to a product or event.

How to use

1. Open the Actor’s Input tab and start with the JSON below.
2. Set profile to the search term or source identifier you want to look up, then use the optional filters listed below.
3. Start the run and open its default dataset to inspect or download the rows.

{
  "profile": "@tiktok",
  "count": 10,
  "cursor": "0"
}

The run dataset can be downloaded as JSON, CSV, Excel or another format offered by Apify.

Input

Field	Type	Required	Description
profile	string	Yes	TikTok username with or without @, full HTTPS TikTok profile URL, or numeric user ID up to 30 digits. Bare numeric values are treated as user IDs; prefix numeric usernames with @.
count	integer	No	Number of posts to return from this page. Scrappa accepts 1-50. Constraints: minimum 1; maximum 50.
cursor	string	No	Pagination cursor from a previous run. Leave empty for the first page.

Output example

The record below is synthetic. Names and links are examples, and private contact fields are omitted.

{
  "desc": "Three ways to style a vintage wool coat for fall. Which look is your favorite?",
  "author": {
    "id": "7210458831",
    "unique_id": "morgan.creates",
    "nickname": "Morgan Creates",
    "avatar": "https://images.example.com/creators/morgan-lee.jpg",
    "follower_count": 18600
  },
  "digg_count": 864,
  "comment_count": 27,
  "share_count": 38,
  "play_count": 18400,
  "create_time": 1790327700,
  "aweme_id": "7348291056172489012"
}

Pricing

Current live price: Apify Free tier: $0.30 per 1,000 results; Bronze: $0.25 per 1,000 results; Silver: $0.22 per 1,000 results; Gold, Platinum, and Diamond: $0.20 per 1,000 results.

Each saved video, post or comment record counts as one result.

FAQ

Is it legal to collect public information?

This Actor is for information visible on the public source pages it reads. You are responsible for checking the source terms, privacy and copyright rules, and the laws that apply to your use.

How many records will a run return?

The result count depends on the input limits, pagination settings and what the source makes available. A small query or unavailable page can return fewer records, including none.

Can I call it through the API or connect it to other tools?

Yes. Send the same JSON input to POST https://api.apify.com/v2/acts/thescrappa~tiktok-user-posts-scraper/runs, then read the run’s default dataset. Make, Zapier and n8n can start runs and pass dataset rows to the next step; Google Sheets can receive rows through those workflows or a dataset export.

What happens when a request fails?

Check the run log for the source or input error, correct the input and retry after a temporary source issue. A run can contain rows saved before a later request failed.

How do I load more posts from a TikTok profile?

Set profile to the public username. Use the returned cursor to continue when TikTok supplies one, and set count to control the requested page size.

Related Scrappa Actors

• TikTok Ads Scraper
• TikTok Hashtag Details Scraper
• TikTok Hashtag Videos Scraper
• TikTok Challenge Search Scraper
• TikTok Comments Scraper