TikTok Search Scraper

Scrape TikTok search results by keyword, top search, hashtag, and creator profile query. This actor is provider-backed, no cookies required, perfect for SEO and AI agents, and MCP optimized for clean natural-language tool calls.

Use it for trend research, creator discovery, content monitoring, social listening, competitive analysis, and lead generation workflows where you need structured TikTok search data in a dataset.

What It Extracts

Video and top-search rows include:

Field	Description
videoId, videoUrl	TikTok video identifiers
caption, hashtags, createdAt	Video content metadata
authorUsername, authorNickname, authorVerified	Creator metadata
playCount, likeCount, commentCount, shareCount, collectCount	Engagement metrics
musicId, musicTitle, musicAuthor	Sound fields when returned
contentType, imageUrls	Top search can include photo carousel results

User search rows include:

Field	Description
username, profileUrl, nickname	TikTok profile identity
bio, verified, avatarUrl	Profile metadata
followerCount, followingCount, heartCount, videoCount	Public profile metrics
privateAccount	Private-account flag when returned

Inputs

• searchQueries plus searchType for keyword videos, top results, users, or all three.
• keywordQueries to always run keyword video search.
• topQueries to always run top mixed search.
• hashtags to search videos by hashtag.
• userQueries to search creator profiles.
• providerOrder to choose ScrapeCreators first, SociaVault first, or one provider only.
• maxResultsPerQuery and maxPagesPerQuery to control pagination and spend.
• region, datePosted, publishTime, and sortBy for provider-supported search filters.
• includeRawData to attach raw provider payloads to each row.

Example Input

{
  "searchQueries": ["nike running"],
  "searchType": "keyword",
  "hashtags": ["running"],
  "userQueries": ["nike"],
  "region": "US",
  "maxResultsPerQuery": 25,
  "maxPagesPerQuery": 3,
  "providerOrder": "scrapecreators-first",
  "includeRawData": false
}

Example Output

{
  "recordType": "video",
  "searchType": "keyword",
  "provider": "scrapecreators",
  "query": "nike running",
  "resultPosition": 1,
  "videoId": "7452069943757114646",
  "videoUrl": "https://www.tiktok.com/@creator/video/7452069943757114646",
  "caption": "Morning miles in the new shoes",
  "authorUsername": "creator",
  "playCount": 2932976,
  "likeCount": 197747,
  "commentCount": 347,
  "shareCount": 26467,
  "scrapedAt": "2026-06-11T00:00:00.000Z"
}

{
  "recordType": "user",
  "searchType": "users",
  "provider": "scrapecreators",
  "query": "nike",
  "resultPosition": 1,
  "username": "nike",
  "profileUrl": "https://www.tiktok.com/@nike",
  "nickname": "Nike",
  "verified": true,
  "followerCount": 7000000,
  "videoCount": 1200,
  "scrapedAt": "2026-06-11T00:00:00.000Z"
}

Run Summary

Every run writes OUTPUT and RUN_SUMMARY records to the default key-value store:

{
  "recordsSaved": 25,
  "targetsProcessed": 1,
  "pagesFetched": 3,
  "providersUsed": ["scrapecreators"],
  "providerAttempts": {
    "scrapecreators.keyword": 3
  },
  "estimatedPpeCostUsd": 0.1001,
  "stopReason": "finished"
}

Common stopReason values:

• finished means selected searches were processed.
• invalid-input means no search query, hashtag, or user query was provided.
• missing-api-key means the actor owner needs to configure provider secrets.
• provider-error means providers returned errors or empty pages.
• event-limit-reached means a PPE charge limit stopped the run cleanly.

Data Source

This actor uses public-data provider APIs:

• ScrapeCreators: TikTok keyword, top, hashtag, and user search endpoints.
• SociaVault: TikTok keyword, top, hashtag, and user search fallback endpoints.

It does not ask users for TikTok cookies and does not scrape private or logged-in TikTok surfaces.