Tiktok Hashtag Scraper

Scrape TikTok videos by hashtag. Extract video metadata, author information, music details, and engagement statistics without requiring login cookies.

Features

• Scrape videos from any public TikTok hashtag
• Extract comprehensive video metadata and engagement stats
• Get author profile information including follower counts
• Automatic anti-bot protection with residential proxies

Input

Parameter	Type	Required	Default	Description
hashtags	array	Yes	-	List of hashtags to scrape (with or without #)
resultsPerPage	integer	No	100	Maximum videos per hashtag (up to 800)
minDelayBetweenRequests	integer	No	3	Minimum delay between actions (seconds)
maxDelayBetweenRequests	integer	No	7	Maximum delay between actions (seconds)
delayBetweenHashtags	integer	No	15	Delay before scraping next hashtag (seconds)

Example Input

{
  "hashtags": ["webscraping", "python", "coding"],
  "resultsPerPage": 100
}

Output

Each video is returned as a JSON object with the following data:

Video Information

Field	Type	Description
id	string	Unique TikTok video ID
text	string	Video caption/description
createTime	integer	Creation timestamp (Unix)
createTimeISO	string	Creation timestamp (ISO 8601)
webVideoUrl	string	Direct URL to the video
isAd	boolean	Whether video is an advertisement

Engagement Stats

Field	Type	Description
playCount	integer	Number of views
diggCount	integer	Number of likes
commentCount	integer	Number of comments
shareCount	integer	Number of shares
collectCount	integer	Number of saves/bookmarks

Author Information

Field	Type	Description
authorMeta.name	string	Username
authorMeta.nickName	string	Display name
authorMeta.verified	boolean	Verification status
authorMeta.signature	string	Bio/description
authorMeta.fans	integer	Follower count
authorMeta.following	integer	Following count
authorMeta.heart	integer	Total likes received
authorMeta.avatar	string	Profile picture URL

Music Information

Field	Type	Description
musicMeta.musicName	string	Track name
musicMeta.musicAuthor	string	Artist name
musicMeta.musicOriginal	boolean	Whether it's original audio
musicMeta.playUrl	string	Audio stream URL

Video Technical Info

Field	Type	Description
videoMeta.duration	integer	Duration in seconds
videoMeta.width	integer	Width in pixels
videoMeta.height	integer	Height in pixels
videoMeta.coverUrl	string	Thumbnail URL
videoMeta.downloadAddr	string	Video download URL

Additional Data

Field	Type	Description
hashtags	array	Hashtags in the video
mentions	array	Users mentioned in caption
challenges	array	TikTok challenges/trends
locationMeta	object	Location info (if available)
searchedHashtag	string	Hashtag used to find this video
scrapedAt	string	When the data was scraped

Example Output

{
  "id": "7204347705928191259",
  "text": "Scraping website tutorial #programmer #webscraping #fyp",
  "createTime": 1677392919,
  "createTimeISO": "2023-02-26T06:28:39.000Z",
  "webVideoUrl": "https://www.tiktok.com/@username/video/7204347705928191259",
  "isAd": false,
  "playCount": 12600,
  "diggCount": 517,
  "commentCount": 27,
  "shareCount": 17,
  "collectCount": 115,
  "authorMeta": {
    "id": "6964254822141297665",
    "name": "username",
    "nickName": "Display Name",
    "verified": false,
    "signature": "Bio text here",
    "avatar": "https://...",
    "fans": 1849,
    "following": 100,
    "heart": 13000
  },
  "musicMeta": {
    "musicName": "LoFi Beat",
    "musicAuthor": "Artist Name",
    "musicOriginal": false
  },
  "videoMeta": {
    "height": 944,
    "width": 576,
    "duration": 164,
    "coverUrl": "https://..."
  },
  "hashtags": [
    { "name": "programmer" },
    { "name": "webscraping" },
    { "name": "fyp" }
  ],
  "searchedHashtag": "webscraping",
  "scrapedAt": "2024-01-30T12:00:00.000Z"
}

Limitations

• Results per Hashtag: TikTok limits results to approximately 400-800 videos per hashtag
• Rate Limiting: Higher delays are recommended for reliable scraping
• Content Availability: Some content may be region-restricted
• Dynamic Content: Results may vary based on TikTok's algorithm

Cost Estimation

Using Apify's pay-per-result pricing:

• $5 per 1,000 results
• Free tier includes $5 credits/month (~1,000 results)

Support

For issues or feature requests, please contact the actor developer through Apify Console.