TikTok Ads Library Scraper — TikTok Creative Center Top Ads
Pricing
from $0.40 / 1,000 ads
Scrape the TikTok Ad Library, TikTok's ads transparency archive: every ad an advertiser runs, with targeting, reach per country, landing page, payer and TikTok account. Plus TikTok Creative Center Top Ads with CTR curves. A TikTok ads scraper and ad spy for competitor ads. No login. Misses free.
row_type
Optional
ad for an ad; commercial_content for a creator's branded post (creators); count for a resultType: counts row; advertiser_match for a resultType: advertisers row; advertiser for an advertiser report (includeAdvertiserReport); advertiser_profile, landing_page and hashtag for the free summaryRows; ended for an ad a complete walk no longer lists (includeEndedAds); not_found for an id TikTok no longer has.
surface
Optional
library — TikTok's Ad Library (ads shown in the EU, EEA, Switzerland and the UK, with the transparency record); top_ads — the Creative Center's Top Ads (TikTok's best-performing ads, worldwide).
creative_id
Optional
TikTok's ad id: the library ad id (16 digits) or the Top Ads id (19 digits). Unique per ad; the key for onlyNewAds.
ad_url
Optional
The ad's page: the library's detail page or the Creative Center's Top Ads page.
ad_format
Optional
video or image (an image ad can hold several images).
creative_available
Optional
Whether TikTok shows the creative. An active ad can have its video and images withheld; removed ads have none.
advertiser_name
Optional
The advertiser as TikTok registers it (library), or the brand name on a Top Ad (often empty there).
advertiser_id
Optional
TikTok's business id of the advertiser (library ads). With advertiser_name it pins the advertiser in advertisers (Name | id).
advertiser_location
Optional
The country the advertiser is registered in, as the library states it.
payer
Optional
Who paid for the ad (the library's "Paid for by"), often an agency.
advertiser_tiktok_username
Optional
The advertiser's TikTok account, when the ad is linked to one.
advertiser_tiktok_name
Optional
That account's display name.
advertiser_tiktok_url
Optional
That account's profile.
advertiser_tiktok_followers
Optional
That account's followers, as a number (the library shows "276.7K").
advertiser_tiktok_avatar_url
Optional
That account's avatar.
advertiser_tiktok_account_type
Optional
The account type TikTok reports (BLUEV_BA = a verified business account).
creator_username
Optional
creators rows: the creator who posted the branded content.
creator_url
Optional
creators rows: the creator's profile.
content_label
Optional
creators rows: TikTok's commercial-content label code (1 or 2), as the library gives it.
body_text
Optional
The ad's caption (library: the ad text; Top Ads: the title).
hook_text
Optional
The caption's first sentence or line — what the viewer reads first.
mentions
Optional
The accounts the caption mentions, without @.
cta
Optional
The call-to-action button as the ad words it ("Shop now"). Library detail only.
cta_type
Optional
The CTA as one value across languages: shop, buy, learn_more, download, install, sign_up, book, contact, … other.
objective
Optional
The campaign objective: the library's advertising objective ("Reach") or the Top Ad's objective ("Conversions").
objectives
Optional
Top Ads: every objective TikTok lists for the ad.
category
Optional
The library's ad category ("Tech & Electronics", "News & Entertainment").
industry
Optional
Top Ads: the industry, by TikTok's own name.
industry_id
Optional
Top Ads: TikTok's industry id (topAdsIndustries takes it).
destination_url
Optional
Where the ad sends the click, with the advertiser's UTM parameters kept.
landing_domain
Optional
The destination's domain.
image_url
Optional
An image ad's first image, or a video ad's cover.
image_urls
Optional
An image ad's images (signed links that expire at media_expires_at).
cover_url
Optional
A video ad's cover frame.
video_url
Optional
The video (library: TikTok's link, which redirects to the CDN; Top Ads: the best rendition).
video_urls
Optional
Top Ads: every rendition, best first: quality ("1080p"), height, url.
video_id
Optional
Top Ads: TikTok's id of the video file.
video_duration_s
Optional
The video's length in seconds.
video_width
Optional
Top Ads: the video's width in pixels.
video_height
Optional
Top Ads: the video's height in pixels.
media_expires_at
Optional
When the signed media links stop working (UTC). downloadMedia stores copies that do not expire.
first_shown
Optional
The ad's first day shown (library). Null where TikTok gives an ad that never ran a placeholder (the moment of the query as both dates).
last_shown
Optional
The ad's last day shown so far (library).
days_shown
Optional
Days from the first to the last day shown, both counted.
is_active
Optional
Still running, by TikTok's own status (tiktok_status) when the run knows it; otherwise last shown today or yesterday and not removed.
tiktok_status
Optional
TikTok's own status of a library ad: active or inactive, as its Ad Library filter lists it (TikTok serves the status as a filter, not a field; an ad last shown yesterday can be inactive). Null where the run could not tell.
launched_last_7_days
Optional
First shown less than 7 days ago.
launched_last_30_days
Optional
First shown less than 30 days ago.
long_running
Optional
Shown for 30 days or more.
posted_at
Optional
creators rows: when the creator posted it (UTC).
audit_status
Optional
The library's audit state: approved or removed.
is_removed
Optional
TikTok removed the ad. The reason is in removal_reasons (detail).
removal_reasons
Optional
Why TikTok removed the ad, in its words (library detail).
display_mode
Optional
The library's display mode of the ad (standard, enhanced).
reach_bucket
Optional
Unique users reached, as the library's band ("10K-100K").
reach_min
Optional
The reach band's lower bound, as a number.
reach_max
Optional
The reach band's upper bound, as a number (null for an open band such as "100K+").
impressions_by_country
Optional
Reach per country, most first: country (ISO-2), impressions as TikTok writes it ("313K" or a band "1K-10K"), impressions_estimate as a number, impressions_min / impressions_max the band's bounds.
top_country
Optional
The country with the most reach (library) or the Top Ads list's country.
countries_count
Optional
How many countries the ad was shown in.
regions
Optional
ISO-2 codes of the countries the ad was shown in — the shape our Google, Meta and LinkedIn ads actors use.
audience_breakdown
Optional
Reach per country × age × gender where TikTok publishes it: country, age, gender, impressions (null where TikTok shows "-").
target_audience_size
Optional
The targeted audience's size, as the library's band ("21.8M-26.6M").
audience_size_min
Optional
The audience-size band's lower bound, as a number.
audience_size_max
Optional
The audience-size band's upper bound, as a number.
targeting_ages
Optional
Age groups targeted in any country (13-17 … 55+).
targeting_genders
Optional
Genders targeted in any country (female, male, unknown).
targeting_by_country
Optional
Per country: country, ages and genders targeted there.
targeting_interests
Optional
Interest categories targeted.
targeting_video_interactions
Optional
Video-interaction categories targeted.
targeting_creator_interactions
Optional
Creator-interaction categories targeted.
targeting_custom_audience
Optional
Whether a custom audience was targeted.
targeting_custom_audience_excluded
Optional
Whether a custom audience was excluded.
targeting_countries
Optional
Countries in the targeting settings.
targeting_cities
Optional
Cities targeted.
targeting_provinces
Optional
Provinces or regions targeted.
targeting_languages
Optional
Languages targeted.
targeting_devices
Optional
Device models targeted.
targeting_os
Optional
Operating systems targeted.
targeting_spending_power
Optional
The high-spending-power setting, when used.
video_views_bucket
Optional
creators rows: the post's views, as the library's band.
video_views_min
Optional
creators rows: the views band's lower bound.
video_views_max
Optional
creators rows: the views band's upper bound.
rank
Optional
Top Ads: the position in the list, in topAdsSortBy order (1 = first). Spotlight: the page's order.
top_ads_country
Optional
Top Ads: the country of the list the ad came from.
top_ads_period
Optional
Top Ads: the period of that list, in days (7, 30 or 180).
ctr_top_percent
Optional
Top Ads: TikTok's CTR rank bucket, as a percentage — 6 means "CTR Top 6%". Lower is better; it is not a click-through rate.
likes
Optional
Top Ads: likes.
cost_level
Optional
Top Ads: TikTok's budget tier for the ad (1 = low … 3 = high).
is_search_ad
Optional
Top Ads: shown in TikTok search.
source
Optional
Top Ads: TikTok's source label for the ad (detail).
keyword_list
Optional
Top Ads: keywords TikTok attaches to the ad (detail).
pattern_labels
Optional
Top Ads: TikTok's creative-pattern label ids (detail).
voice_over
Optional
Top Ads: the video has a voice-over (detail).
highlight_text
Optional
Top Ads: TikTok's own note on the ad — on Spotlight ads, why its creative team picked it.
keyframes
Optional
Top Ads (topAdsMetrics): per-second curves ctr, cvr, clicks, conversions, retention, each a list of second, value (TikTok's relative values).
keyframe_highlights
Optional
Top Ads (topAdsMetrics): the seconds TikTok marks on each curve (ctr, cvr, …), a list of seconds per curve.
percentiles
Optional
Top Ads (topAdsMetrics): the ad's percentile against other ads for ctr, cvr, clicks, conversions, impressions (0–1).
copy_length
Optional
The caption's length in characters.
text_language
Optional
The caption's language by a word vote (ISO 639-1); null when too short to tell.
sentiment_score
Optional
The caption's sentiment, −1 to 1, from the AFINN word list — English captions only.
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 for (purchase, signup, download, learn_more, contact, visit, watch, apply, book, other).
analysis_tone
Optional
tagAds: the tone (playful, urgent, professional, friendly, luxurious, informative, emotional, bold, other).
analysis_sentiment
Optional
tagAds: the caption's sentiment, −1 to 1.
analysis_offer_type
Optional
tagAds: what is offered (discount, giveaway, app_or_game, entertainment, physical_product, free_tool_or_trial, event_or_webinar, product_announcement, … other).
analysis_funnel_stage
Optional
tagAds: awareness, consideration or conversion.
analysis_confidence
Optional
tagAds: the confidence (0–1) of each tag, by tag name.
analysis_hook
Optional
analyzeAds: the line meant to stop the scroll.
analysis_offer
Optional
analyzeAds: the concrete offer, or null.
analysis_audience
Optional
analyzeAds: who the ad is written for.
analysis_strategy
Optional
analyzeAds: what the advertiser is doing with this ad, in one sentence.
ad_ocr_text
Optional
ocrImageAds: the words in an image ad's artwork.
transcript
Optional
transcribeVideos: what the video says. A video longer than 3 minutes is transcribed for its first 3 minutes.
transcript_language
Optional
transcribeVideos: the spoken language (ISO 639-1).
hook_3s
Optional
transcribeVideos: the words spoken in the first three seconds of speech.
speech_seconds
Optional
transcribeVideos: seconds of speech in the video.
transcript_segments
Optional
transcribeVideos: the transcript in timed segments (start, end, text).
media_files
Optional
downloadMedia: the stored files — kind, key, url (does not expire), bytes, content_type, source_url, reused.
image_file_url
Optional
downloadMedia: the stored first image or cover.
video_file_url
Optional
downloadMedia: the stored video.
detail_status
Optional
ok (the detail record is on the row), skipped (details off), not_found, or failed: … (not billed for details).
matched_query
Optional
The search that found the row (the advertiser, keyword, creator, URL or Top Ads list).
claimed_count
Optional
TikTok's own total for that search (library), or the Top Ads list's total.
claimed_count_is_capped
Optional
The total is TikTok's 5,000 ceiling for a keyword: the real number is at least that.
scraped_at
Optional
When the row was read (UTC).
first_seen_at
Optional
Monitoring: the day a run of this search first saw the ad.
last_seen_at
Optional
Monitoring: the last day a run saw it.
ended_at
Optional
ended rows: the day a complete walk no longer listed the ad.
times_seen
Optional
Monitoring: on how many days a run of this search saw the ad.
previous_rank
Optional
Monitoring, Top Ads: the ad's rank the last time it was delivered.
change_type
Optional
Monitoring: new, changed (delivered before, a watched field moved) or unchanged.
changed_fields
Optional
Monitoring: which fields moved (last_shown, reach_bucket, audit_status, likes, ctr_top_percent).
run_tag
Optional
Your runTag, on every row.
search_query
Optional
count and advertiser_match rows: the library page of that search.
has_ads
Optional
count and advertiser_match rows: whether the search finds any ad.
exact_name_match
Optional
advertiser_match rows: TikTok's name is exactly the name you gave.
report_ads_published_by_month
Optional
advertiser rows: ads published per month — month, ads.
report_ads_published
Optional
advertiser rows: ads published in the window.
report_first_published
Optional
advertiser rows: the first day with a new ad in the window.
report_last_published
Optional
advertiser rows: the last day with a new ad in the window.
summary_ad_count
Optional
Summary rows: ads counted.
summary_active_count
Optional
advertiser_profile: of those, still running.
summary_removed_count
Optional
advertiser_profile: of those, removed by TikTok.
summary_longest_days
Optional
advertiser_profile: the longest run in days.
summary_formats
Optional
advertiser_profile: ads per format.
summary_landing_domains
Optional
Summary rows: the landing domains.
summary_countries
Optional
advertiser_profile: ads per country.
summary_distinct_copies
Optional
advertiser_profile: distinct captions.
summary_ad_ids
Optional
Summary rows: the ad ids counted.
summary_advertisers
Optional
hashtag rows: the advertisers using the hashtag.
error
Optional
true on the one row a rejected input writes; absent on a result row
code
Optional
why the input was rejected, as a code (INPUT REJECTED runs only)
message
Optional
what to change, in words (INPUT REJECTED runs only)
comments
Optional
Top Ads: comments (detail).