Skip to main content
GET
Get Results
Retrieve scraped data from your TikTok Top Ads Scraper runs.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

string
required
Hash of the squid to get results from
string
Hash of a specific run (optional)
integer
Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:
string
Unique TikTok internal identifier for the ad. Example: 7183244447446040577
string
Direct URL to the ad listing in TikTok Ads Library. Example: https://ads.tiktok.com/business/creativecenter/topads/7183244447446040577
string
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 Game
integer
Relative cost or spend level indicator of the ad. Example: 2
float
Click-through rate (CTR) of the ad. Example: 0.16
boolean
Whether the ad is bookmarked in TikTok Ads Library. Example: false
string
Internal key for the ad’s industry category. Example: label_25310000000
string
Industry category the ad belongs to. Example: Strategy
Whether this ad was returned via a search in TikTok Ads Library. Example: false
integer
Number of likes the ad video received. Example: 1316378
string
Internal key for the campaign objective. Example: campaign_objective_app_install
string
Campaign objective (e.g. App Installs, Traffic, Conversions). Example: App Installs
integer
Category tag assigned to the ad in TikTok Ads Library. Example: 3
string
Internal TikTok identifier for the ad video. Example: v0911dg40001cen4er3c77ubsnsedsp0
float
Duration of the ad video in seconds. Example: 34.368
string
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=my
string
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=e00088000
string
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=e00088000
integer
Width of the ad video in pixels. Example: 720
integer
Height of the ad video in pixels. Example: 1280
string
Keywords associated with the ad in TikTok Ads Library
string
URL of the landing page the ad directs users to
integer
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