TikTok Profile & Public Videos Scraper

What does TikTok Profile & Public Videos Scraper do?

TikTok Profile & Public Videos Scraper resolves public TikTok profile URLs or usernames and returns the creator's public profile metadata plus one paginated page of public videos. It works as a TikTok profile API alternative for public data and also accepts a raw secUserId when profile metadata is not needed.

Why use TikTok Profile & Public Videos Scraper?

• Accept profile URLs, @usernames, plain usernames, and raw TikTok secUserId values.
• Resolve public creator metadata including nickname, biography, verification status, avatar, and public counters.
• Fetch up to 50 public video records per profile request with TikTok cursor pagination.
• Process multiple profiles concurrently with independent per-profile results.
• Run on a schedule, call the Actor through the Apify API, monitor runs, and export results to Apify integrations.
• Route TikTok traffic through Apify Residential Proxy by default, with support for private proxy deployments.
• Success-based pricing: failed, missing, challenged, or unavailable profiles are returned with an error and are not charged.

What data can TikTok Profile & Public Videos Scraper extract?

Field	Type	Description
profile	object or null	Normalized public creator identity, avatar, biography, verification, and counters. It is null for direct secUserId inputs.
secUserId	string	TikTok's stable secured user identifier used for video pagination.
items	array	Raw public TikTok video records returned for the requested page.
hasMore	boolean	Whether TikTok reports that another page is available.
cursor	string or integer	Cursor to pass into a later run for the next page.
error	string or null	A safe per-profile error message. One failed profile does not discard other results.

How to scrape TikTok profiles

1. Open the Actor's Input tab.
2. Add one or more public TikTok profile URLs, usernames, or secUserId values to profiles.
3. Leave cursor as 0 for the first page and choose a count between 1 and 50.
4. Start the run and wait for the Dataset output.
5. If hasMore is true, run the Actor again with the returned cursor to request the next page.

How much will it cost to scrape TikTok?

The Actor costs $1.20 per 1,000 successfully scraped TikTok profiles ($0.0012 per success). A run with 100 successful profile results costs $0.12. Failed, missing, challenged, private, or unavailable profiles still receive a Dataset row with success: false, but they are not charged.

Each successful input profile is charged once, regardless of how many video records TikTok returns in that page. The event price includes Apify platform usage during the run. Dataset reads and long-term storage after the run remain subject to Apify's standard platform pricing. A custom proxy can have separate charges from its provider.

Before publishing, enable Pay per event in the Actor's Apify Console monetization settings and configure the profile-scraped event from .actor/pay_per_event.json. Without that platform setting, the SDK safely ignores charge attempts while still writing Dataset results.

Input

See the input tab for full configuration options. A typical first-page request is:

{
  "profiles": [
    "https://www.tiktok.com/@gordonramsayofficial",
    "@demo.creator",
    "MS4wLjABAAAA_example_sec_user_id_value"
  ],
  "cursor": "0",
  "count": 21
}

Output

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. One Dataset item is written for each unique input profile:

{
  "source": "@demo.creator",
  "success": true,
  "profile": {
    "username": "demo.creator",
    "secUserId": "MS4wLjABAAAA...",
    "nickname": "Demo Creator",
    "verified": false,
    "stats": {
      "followers": 1200,
      "following": 50,
      "likes": 8400,
      "videos": 32
    }
  },
  "secUserId": "MS4wLjABAAAA...",
  "items": [{ "aweme_id": "1234567890" }],
  "hasMore": true,
  "cursor": 1720000000000,
  "error": null
}

Tips and advanced options

• Apify Residential Proxy is used by default; private proxy deployments can replace it.
• Challenge or incomplete profile pages are retried immediately with a fresh Apify Proxy session.
• Use moderate concurrency for more stable results when processing large batches.
• A direct secUserId skips the public profile-page request and therefore returns profile: null.
• The Actor retries temporary TikTok HTTP errors and transient capacity failures.
• A challenge retry creates a fresh HTTP session and, with Apify Residential Proxy, a new proxy session ID so the next attempt can use another IP.

Related TikTok Actors

• TikTok Bulk Video Search searches public TikTok videos by keyword and returns structured video records.
• TikTok Video Downloader API - Direct Video URLs converts TikTok video and short links into direct playback/download URLs and metadata.

FAQ, disclaimers, and support

Does the Actor extract private TikTok data?

No. It requests only public profile and public video information and does not log in to TikTok on behalf of a user.

Our Actor is designed not to extract private user data such as email addresses, gender, or private location. It only extracts information the user has chosen to share publicly. Results can still contain personal data protected by the GDPR and other laws. Do not scrape personal data without a legitimate reason; consult legal counsel if you are unsure.

Use the Actor's API tab for programmatic access. For bugs or feature requests, open the Actor's Issues tab and include a sanitized input example and run ID; never include credentials.