Get Results
TikTok Top Ads Scraper
Get Results
Retrieve scraped data from TikTok Top Ads Scraper
GET
Get Results
Retrieve scraped data from your TikTok Top Ads Scraper runs.
Headers
string
required
Your API authentication token. Value:
Token YOUR_API_KEYQuery Parameters
string
required
Hash of the squid to get results from
string
Hash of a specific run (optional)
integer
Page number (default: 1). Example:
1Result Fields
Each result object contains the following fields:string
Unique TikTok internal identifier for the ad. Example:
7183244447446040577string
Direct URL to the ad listing in TikTok Ads Library. Example:
https://ads.tiktok.com/business/creativecenter/topads/7183244447446040577string
Title or headline of the TikTok advertisement. Example:
Omg Top War is SOOO fun!!string
Name of the brand running the ad. Example:
Top War: Battle Gameinteger
Relative cost or spend level indicator of the ad. Example:
2float
Click-through rate (CTR) of the ad. Example:
0.16boolean
Whether the ad is bookmarked in TikTok Ads Library. Example:
falsestring
Internal key for the ad’s industry category. Example:
label_25310000000string
Industry category the ad belongs to. Example:
Strategyboolean
Whether this ad was returned via a search in TikTok Ads Library. Example:
falseinteger
Number of likes the ad video received. Example:
1316378string
Internal key for the campaign objective. Example:
campaign_objective_app_installstring
Campaign objective (e.g. App Installs, Traffic, Conversions). Example:
App Installsinteger
Category tag assigned to the ad in TikTok Ads Library. Example:
3string
Internal TikTok identifier for the ad video. Example:
v0911dg40001cen4er3c77ubsnsedsp0float
Duration of the ad video in seconds. Example:
34.368string
URL of the ad video’s thumbnail image. Example:
https://p16-sign-va.tiktokcdn.com/tos-maliva-v-2c3654-us/486619c74ee8418fba7fa56e4ca774ad~tplv-noop.image?dr=18692&refresh_token=9e8e25b8&x-expires=1769020412&x-signature=jNdfeXCC98Xb3JPjqjh0CiqPEtg%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=mystring
URL of the ad video file at 720p resolution. Example:
https://v16m-default.tiktokcdn.com/9afb882c10114d99b9b0186102ce930a/69711bfc/video/tos/maliva/tos-maliva-v-2c3654-us/oskBSNsbfKpj8BEvQdTk1m5nQDdRJ2gflHrcIa/?a=0&bti=NTU4QDM1NGA%3D&ch=0&cr=0&dr=0&lr=tiktok_business&cd=0%7C0%7C0%7C0&cv=1&br=4390&bt=2195&cs=0&ds=3&ft=cApXJCz7ThWHcWX01GZmo0P&mime_type=video_mp4&qs=0&rc=OjNlOmc6Njg5OTQ0Njs7Z0BpM3ZocWU6ZnU3aDQzN2c0M0AyLzNgL18yNTExMzZgL2JgYSNtYXBwcjQwYmtgLS1kLjZzcw%3D%3D&vvpl=1&l=202601212032587548419764747B268087&btag=e00088000string
URL of the ad video file at 540p resolution. Example:
https://v16m-default.tiktokcdn.com/0d3b90a85935bd1edad867f6de9bf21f/69711bfc/video/tos/maliva/tos-maliva-v-2c3654-us/ooRHdsQQJXE8kDkmfn15vrbfVdnDBBNINgSjlK/?a=0&bti=NTU4QDM1NGA%3D&ch=0&cr=0&dr=0&lr=tiktok_business&cd=0%7C0%7C0%7C0&cv=1&br=3180&bt=1590&cs=0&ds=6&ft=cApXJCz7ThWHcWX01GZmo0P&mime_type=video_mp4&qs=0&rc=NTY1ZWY2aTs4NTVoZWk8O0BpM3ZocWU6ZnU3aDQzN2c0M0A2Nl9iYWNfNWAxLy1gMy8wYSNtYXBwcjQwYmtgLS1kLjZzcw%3D%3D&vvpl=1&l=202601212032587548419764747B268087&btag=e00088000integer
Width of the ad video in pixels. Example:
720integer
Height of the ad video in pixels. Example:
1280string
Keywords associated with the ad in TikTok Ads Library
string
URL of the landing page the ad directs users to
Number of times the ad video was shared
string
Platform where the ad is served (e.g. TikTok)
integer
Number of comments on the ad video
json
ISO 2-letter country code of the ad’s target region
boolean
Whether the ad has a summary section in TikTok Ads Library
string
Highlight or badge label shown on the ad in TikTok Ads Library
json
List of campaign objectives associated with the ad
json
Creative pattern label categorizing the ad’s visual format
integer
Internal key identifying the ad source
boolean
Whether the ad video includes a voice-over track
json
Raw detail data returned by the TikTok Ads Library API