GET/v1/results

Get Results

Retrieve scraped TikTok top ads data

Retrieve the scraped TikTok top ads data from your runs. Results include ad details, brand information, engagement metrics, video URLs, and performance data.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Result Fields

internal_id
string
Unique identifier for the ad
Example: 6916651063119348000
url
string
URL to the ad on TikTok Creative Center
Example: https://ads.tiktok.com/business/creativecenter/topads/6916651063119348000
ad_title
string
Title or caption of the ad
Example: Don't miss out on our sale before we sell out!
brand_name
string
Name of the brand running the ad
Example: GlowSkin
ctr
float
Click-through rate of the ad
Example: 0.58
industry
string
Industry category of the ad
Example: Beauty & Personal Care
objective
string
Campaign objective of the ad
Example: Conversion
like
integer
Number of likes on the ad
Example: 14523
share
integer
Number of shares on the ad
Example: 2341
comment
integer
Number of comments on the ad
Example: 892
video_info_duration
float
Duration of the video in seconds
Example: 15.016
video_info_cover
string
URL to the video cover image
Example: https://p16-cc-sign-sg.ibyteimg.com/...
video_info_video_url_720p
string
URL to the 720p version of the video
Example: https://v16m-default.akamaized.net/...
video_info_width
integer
Video width in pixels
Example: 576
video_info_height
integer
Video height in pixels
Example: 576
keywords
string
Keywords associated with the ad
Example: skincare, beauty, sale
landing_page
string
Landing page URL for the ad
Example: https://example.com/shop
country_code
json
Countries where the ad is shown
Example: [US, CA, GB]
voice_over
boolean
Whether the ad has voice-over
Example: true

Parameters

squidstring
Required
Hash of the squid to get results from
Example: b6ab0f03b02e472a8e2ab0b16b4fdd0f
runstring
Optional
Hash of a specific run (optional, filters to that run only)
Example: c29f2f1464ec45d599b1b4f43595bf3a
pageinteger
Optional
Page number (default: 1)
Example: 1
page_sizeinteger
Optional
Results per page (default: 50, max: 100)
Example: 50
Pro Tip

Pro Tip

Use `video_info_video_url_720p` to download the actual ad video for analysis.
Pro Tip

Pro Tip

The `ctr` (click-through rate) field helps identify high-performing ads.
Note

Note

Video URLs may expire after some time. Download videos promptly if you need to archive them.