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 US Apify Residential Proxy by default, with support for private proxy deployments.
• Result-based pricing: failed, missing, challenged, or unavailable profiles do not incur profile or video-result charges.

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 charges $0.001 when a run starts, $0.002 for each successfully scraped profile, and $0.0003 for each public TikTok video returned inside that profile result. For example, one successful profile with 21 videos costs $0.001 + $0.002 + (21 × $0.0003) = $0.0093.

Failed, missing, challenged, private, or unavailable profiles still receive a Dataset row with success: false, but they do not incur profile or video-result charges. The run-start charge still applies. Event prices include 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 apify-actor-start, profile-scraped, and video-result events from .actor/pay_per_event.json. Apify charges the synthetic start event automatically; the Actor must not charge it manually. During a pricing transition, the code charges video-result only after that event appears in the run's effective pricing. Without PPE enabled, 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 as each unique input profile finishes, in completion order. Saved records remain available if the run stops early. Use source to match each record to its input.

Billing and run progress are updated as records are written, and pending work is stopped when the run charge limit is reached. Example record:

{
  "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

• US Apify Residential Proxy is used by default; private proxy deployments can replace it.
• Challenge or incomplete profile pages are retried immediately through a new proxy connection with automatic IP selection.
• Request behavior is configurable with TIKTOK_REQUEST_TIMEOUT_SECS, TIKTOK_MAX_REQUEST_RETRIES, and TIKTOK_MAX_CHALLENGE_RETRIES. Their defaults are 10 seconds, 1 HTTP retry, and 1 challenge retry, respectively.
• 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.
• Proxy requests, including HTTP and challenge retries, open new connections so Apify can select an exit IP automatically without a proxy session ID.

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.