TikTok Signals & Creator Data Scraper API

TikTok scraper API for extracting structured creator profiles, videos, search results, hashtags, followers, and comments from one Apify Actor. Use it for creator intelligence, trend discovery, monitoring, audience research, and agent workflows without separate TikTok integrations.

What this TikTok scraper extracts

• Creator profiles by username
• Creator video feeds by secUid
• Video details by ID or share URL
• Video comments with pagination
• Keyword-based video search
• Hashtag video feeds by challenge ID
• Creator followers by secUid

Each target becomes one structured dataset row. Each successful target costs $0.0035; failed targets become uncharged error rows.

Example input

{
  "operation": "profile",
  "targets": ["tiktok", "natgeo"],
  "count": 15,
  "region": "US",
  "includeRaw": false,
  "failOnError": false,
  "maxConcurrency": 3
}

Operation	Target format
profile	Username, with or without @
posts, followers	Creator secUid
video, comments	Video ID
share_url	Full TikTok share URL
search	Search keyword
hashtag	Hashtag challenge ID

For paginated search runs, pass both cursor as the numeric offset and searchId from the previous response.

Output and API use

The default dataset contains product, platform, operation, target, endpoint, success, requestId, fetchedAt, latencyMs, data, and error. Run it through the Apify API:

curl -X POST "https://api.apify.com/v2/acts/oneary~tiktok-signals-creator-data-scraper-api/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @examples/input.json

Reliability and security

• The Actor respects the maximum charge selected for each run.
• Concurrency is bounded between 1 and 10.
• Credentials are read only from environment variables.
• Errors never include authentication headers or keys.
• failOnError supports strict automation pipelines.

Use the Actor only for lawful, authorized data workflows and follow applicable platform terms, privacy rules, and retention requirements.

Development

npm test
npm run lint
npm run typecheck
npm run validate:actor
npm run build