TikTok Trends Scraper: TikTok Creative Center Hashtags, Top Ads
Pricing
from $1.00 / 1,000 trending hashtags
Scrape TikTok Creative Center trends: TikTok trending hashtags in 27 countries over 7, 30 or 90 days with every industry list, TikTok trending videos with weekly and monthly rankings and comments, and TikTok Top Ads with details. A TikTok ads scraper with exact numbers. No login.
record_id
Optional
Unique across sections and runs of the same list: hashtag:<country>:<period>:<id>, video:<country>:<period>:<end date>:<id>, top_ad:<id>; free rows carry their own (section:songs, not_listed:…). Deduplicate on this.
section
Optional
hashtags, videos, top_ads, summary, or the name of a section TikTok dropped (songs, creators, products, keywordInsights).
row_type
Optional
hashtag, video, ad (charged rows); section_unavailable, section_returned, not_listed, no_snapshot, not_found, ended, caption_hashtag, advertiser_profile, landing_page (free); digest (the trend digest).
country
Optional
ISO country code of the list the row comes from.
country_name
Optional
The country's name.
period
Optional
Hashtags and Top Ads: the window in days (7, 30, 90, 180); videos: last_7_days, last_30_days, weekly or monthly.
period_days
Optional
Days the window covers.
period_start
Optional
Videos: the first day of the ranking's window.
period_end
Optional
Videos: the last day of the ranking's window — the snapshot TikTok keys the list by.
rank
Optional
Position in list (1 = top). Hashtags: TikTok's rank; videos: the position in the list; Top Ads: the position in the order you asked for.
list
Optional
The list the rank is from: Overall or an industry for hashtags; sort / content tag / organic for videos; the Top Ads list.
lists
Optional
Every list of the slice this entry ranked in, with its rank there (a hashtag can top the overall list and an industry list).
list_served
Optional
Rows TikTok served in that list. Logged out TikTok shows 3 hashtags and 4 videos per list.
list_total
Optional
TikTok's own count for the list (videos: 100 ranked; hashtags: the rows it serves logged out).
hashtag_id
Optional
TikTok's hashtag id, as a string.
hashtag_name
Optional
The hashtag without #.
hashtag_url
Optional
The hashtag's tiktok.com page.
creative_center_url
Optional
The hashtag's Creative Center page for this country and period.
posts
Optional
Videos posted with the hashtag in the period (exact, as the API gives it).
views
Optional
Hashtags: views of the hashtag's videos in the period; videos: the video's views in the window. Exact.
industries
Optional
The hashtag's own industries, by name (TikTok's taxonomy).
industry_ids
Optional
The same industries, by id.
popularity_curve
Optional
TikTok's 0–100 popularity per day (peak = 100) over the window: [{date, value}], one point per day the hashtag was present.
curve_points
Optional
Days in the curve.
trend_direction
Optional
up / down at ±10 % momentum, else flat.
trend_momentum_pct
Optional
Mean of the curve's last 3 points against the 3 before them, in %; when those 3 are all 0, against the mean of every earlier point; null when every earlier point is 0 (not there yet).
trend_volatility
Optional
Standard deviation of the day-to-day changes of the curve, in points.
trend_stage
Optional
emerging (present on fewer than half the window's days and not falling), peaking (latest ≥ 90), rising, declining or steady.
trend_peak_date
Optional
The latest day the curve hit its maximum.
trend_average
Optional
Mean of the curve.
trend_latest
Optional
The curve's last value.
top_creators
Optional
TikTok's top 3 creators for the hashtag: rank, user id, handle, nickname, followers, country, avatar, profile URL (and the stored avatar with downloadMedia).
video_id
Optional
TikTok's video id, as a string (19 digits; never a float).
video_page_url
Optional
The video's tiktok.com page.
title
Optional
The video's caption.
video_created_at
Optional
When the video was posted (UTC).
views_lifetime
Optional
The video's views since it was posted.
organic_views
Optional
Views in the window not from ads.
organic_views_lifetime
Optional
Organic views since it was posted.
engagement_rate
Optional
TikTok's engagement rate in the window (a share, 0.0012 = 0.12 %).
engagement_rate_lifetime
Optional
The same since it was posted.
six_second_view_rate
Optional
Share of views that watched 6 seconds, in the window.
six_second_view_rate_lifetime
Optional
The same since it was posted.
creator_username
Optional
The video creator's handle.
creator_nickname
Optional
The creator's display name.
creator_url
Optional
The creator's tiktok.com page.
creator_id
Optional
The source's creatorID of the video.
creator_bio
Optional
The creator's bio as TikTok shows it.
creator_avatar_url
Optional
The creator's avatar (a signed link that expires).
creator_followers
Optional
The creator's followers.
creator_store_region
Optional
With videoDetails: the creator's store region (US videos only).
creator_type
Optional
With videoDetails: the source's creator type code.
content_tag_ids
Optional
The same tags, by id.
top_comments
Optional
With videoDetails: the video's top comments with likes, date, comment id, user id and name (US videos).
top_comments_count
Optional
How many comments the detail record held.
comment_keywords
Optional
With videoDetails: the keywords TikTok extracts from the comments, with mentions (when it has them).
creative_id
Optional
The Top Ad's id.
ad_url
Optional
The ad's Creative Center page.
ad_format
Optional
video (the Creative Center renders every Top Ad as a video).
creative_available
Optional
Whether the ad carries a video or a cover.
advertiser_name
Optional
The brand name TikTok shows.
body_text
Optional
The ad's caption.
hook_text
Optional
The caption's first line or sentence.
objective
Optional
The campaign objective.
objectives
Optional
Every objective of the detail record.
industry
Optional
The ad's industry, by name.
industry_id
Optional
The same, by id.
destination_url
Optional
Where the ad leads (detail record).
landing_domain
Optional
The landing page's domain.
ctr_top_percent
Optional
TikTok's CTR rank bucket: 6.0 = "Top 6 %" — lower is better; not a click rate.
likes
Optional
The ad's likes.
cost_level
Optional
TikTok's budget tier of the ad (1–3).
is_search_ad
Optional
Whether TikTok marks it a search ad.
source
Optional
The detail record's source (where TikTok took the ad from).
keyword_list
Optional
The detail record's keyword list.
pattern_labels
Optional
TikTok's creative pattern labels.
voice_over
Optional
Whether the ad has a voice-over.
highlight_text
Optional
Spotlight ads: TikTok's expert note.
regions
Optional
Countries the ad ran in (detail record).
keyframes
Optional
With topAdsMetrics: per-second CTR, CVR, clicks, conversions and retention curves.
keyframe_highlights
Optional
The seconds TikTok marks on the curves.
percentiles
Optional
With topAdsMetrics: CTR, CVR, clicks, conversions and impressions percentiles.
copy_length
Optional
Characters in the caption.
sentiment_score
Optional
AFINN sentiment of an English caption (−1…1); null for other languages.
image_url
Optional
The ad's cover image (signed link).
video_urls
Optional
Every rendition of the ad video, best first, with its height.
video_duration_s
Optional
The ad video's length in seconds.
video_width
Optional
Pixels.
video_height
Optional
Pixels.
cover_url
Optional
The video's or the ad's cover (a signed link that expires).
video_url
Optional
The video file (a signed link that expires at media_expires_at).
media_expires_at
Optional
When TikTok's signed video link stops working.
mentions
Optional
@handles written in the title or caption.
text_language
Optional
en when the title or caption is English, else null.
analysis_angle
Optional
tagAds: the persuasion angle (problem_solution, social_proof, scarcity, discount, feature, lifestyle, curiosity, education, comparison, brand, other).
analysis_cta_intent
Optional
tagAds: what the ad asks the viewer to do.
analysis_tone
Optional
tagAds: the tone of the copy.
analysis_sentiment
Optional
tagAds: valence from −1 to 1.
analysis_offer_type
Optional
tagAds: what the ad offers.
analysis_funnel_stage
Optional
tagAds: awareness, consideration or conversion.
analysis_confidence
Optional
tagAds: the confidence of each tag.
analysis_hook
Optional
analyzeAds: the hook line.
analysis_offer
Optional
analyzeAds: the concrete offer.
analysis_audience
Optional
analyzeAds: who the ad is written for.
analysis_strategy
Optional
analyzeAds: what the advertiser is trying to achieve.
transcript
Optional
transcribeVideos: the spoken words.
transcript_language
Optional
transcriptTiming: the language spoken (ISO 639-1).
hook_3s
Optional
transcribeVideos: the first words; with transcriptTiming, the words of the first 3 seconds of speech.
speech_seconds
Optional
transcriptTiming: seconds of speech.
transcript_segments
Optional
transcriptTiming: the transcript with start and end times.
media_files
Optional
downloadMedia: the files stored in the run's key-value store, with links that do not expire.
image_file_url
Optional
downloadMedia: the stored cover.
video_file_url
Optional
downloadMedia: the stored video.
detail_status
Optional
ok, skipped (not asked), login_required (TikTok serves it logged in only), not_found, or failed: …. Only ok is charged.
source_url
Optional
The Creative Center page of the row: a hashtag's own page (= creative_center_url), a video list's page, a Top Ad's page.
scraped_at
Optional
When the run read the row (UTC).
first_seen_at
Optional
With the memory: the day this task first met the entry.
last_seen_at
Optional
With the memory: the last day this task met it.
ended_at
Optional
ended rows: the day a complete read no longer found it.
times_seen
Optional
With the memory: runs of this task that met the entry.
previous_rank
Optional
With the memory: the rank the last earlier run of this task delivered it at (the newest snapshot of that run).
rank_change
Optional
previous_rank − rank: positive = moved up.
rank_velocity_per_day
Optional
rank_change divided by the days since the previous rank; null when the previous rank is from the same day.
is_new
Optional
With the memory: true the first time this task meets the entry.
change_type
Optional
With the memory: new, seen_before, or changed (a Top Ad whose likes or CTR moved).
changed_fields
Optional
The fields that moved.
note
Optional
Free rows: what TikTok answered, or why the row is there.
source_answer
Optional
Free rows of a dropped section: the head of TikTok's answer.
run_tag
Optional
Your runTag, copied onto every row.
summary_video_count
Optional
Summary rows: videos that carry it.
summary_ad_count
Optional
Summary rows: Top Ads that carry it.
summary_is_trending
Optional
caption_hashtag rows: the same run delivered it as a trending hashtag.
summary_record_ids
Optional
Summary rows: the rows behind it.
summary_advertisers
Optional
Summary rows: the brands behind it.
summary_landing_domains
Optional
advertiser_profile rows: the brand's landing domains.
summary_countries
Optional
advertiser_profile rows: ads per country.
digest_summary
Optional
trendDigest: what is trending in the lists the run read.
digest_themes
Optional
trendDigest: themes with the entries behind each.
digest_rising
Optional
trendDigest: hashtags with rising curves, by name.
digest_watch
Optional
trendDigest: concrete things to act on, each tied to an entry.
comments
Optional
The ad's comments (detail record).