Get Results
Retrieve scraped data from TikTok Top Ads Scraper
https://api.lobstr.io/v1/resultsRetrieve scraped data from your TikTok Top Ads Scraper runs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
squidstringqueryrequiredHash of the squid to get results from
runstringqueryHash of a specific run (optional)
pageintegerqueryPage number (default: 1). Example: 1
Result Fields
Each result object contains the following fields:
internal_idstringUnique TikTok internal identifier for the ad. Example: 7183244447446040577
urlstringDirect URL to the ad listing in TikTok Ads Library. Example: https://ads.tiktok.com/business/creativecenter/topads/7183244447446040577
ad_titlestringTitle or headline of the TikTok advertisement. Example: Omg Top War is SOOO fun!!
brand_namestringName of the brand running the ad. Example: Top War: Battle Game
costintegerRelative cost or spend level indicator of the ad. Example: 2
ctrfloatClick-through rate (CTR) of the ad. Example: 0.16
favoritebooleanWhether the ad is bookmarked in TikTok Ads Library. Example: false
industry_keystringInternal key for the ad's industry category. Example: label_25310000000
industrystringIndustry category the ad belongs to. Example: Strategy
is_searchbooleanWhether this ad was returned via a search in TikTok Ads Library. Example: false
likeintegerNumber of likes the ad video received. Example: 1316378
objective_keystringInternal key for the campaign objective. Example: campaign_objective_app_install
objectivestringCampaign objective (e.g. App Installs, Traffic, Conversions). Example: App Installs
tagintegerCategory tag assigned to the ad in TikTok Ads Library. Example: 3
video_info_vidstringInternal TikTok identifier for the ad video. Example: v0911dg40001cen4er3c77ubsnsedsp0
video_info_durationfloatDuration of the ad video in seconds. Example: 34.368
video_info_coverstringURL 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
video_info_video_url_720pstringURL 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
video_info_video_url_540pstringURL 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
video_info_widthintegerWidth of the ad video in pixels. Example: 720
video_info_heightintegerHeight of the ad video in pixels. Example: 1280
keywordsstringKeywords associated with the ad in TikTok Ads Library
landing_pagestringURL of the landing page the ad directs users to
shareintegerNumber of times the ad video was shared
sourcestringPlatform where the ad is served (e.g. TikTok)
commentintegerNumber of comments on the ad video
country_codejsonISO 2-letter country code of the ad's target region
has_summarybooleanWhether the ad has a summary section in TikTok Ads Library
highlight_textstringHighlight or badge label shown on the ad in TikTok Ads Library
objectivesjsonList of campaign objectives associated with the ad
pattern_labeljsonCreative pattern label categorizing the ad's visual format
source_keyintegerInternal key identifying the ad source
voice_overbooleanWhether the ad video includes a voice-over track
detail_rawjsonRaw detail data returned by the TikTok Ads Library API
Response
{ "total_results": 1, "limit": 50, "page": 1, "total_pages": 1, "result_from": 1, "result_to": 1, "data": [ { "id": 22424, "object": "result", "squid": "382c3dfe84f18e2deb860db2ffea7f63", "run": "74e47042fb999e9edafb0f7a003c3795", "internal_id": "7183244447446040577", "url": "https://ads.tiktok.com/business/creativecenter/topads/7183244447446040577", "ad_title": "Omg Top War is SOOO fun!!", "brand_name": "Top War: Battle Game", "cost": 2, "ctr": 0.16, "favorite": false, "industry_key": "label_25310000000", "industry": "Strategy", "is_search": false, "like": 1316378, "objective_key": "campaign_objective_app_install", "objective": "App Installs", "tag": 3, "video_info_vid": "v0911dg40001cen4er3c77ubsnsedsp0", "video_info_duration": 34.368, "video_info_cover": "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", "video_info_video_url_720p": "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", "video_info_video_url_540p": "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", "video_info_width": 720, "video_info_height": 1280, "keywords": null, "landing_page": null, "share": null, "source": null, "comment": null, "country_code": null, "has_summary": null, "highlight_text": null, "objectives": null, "pattern_label": null, "source_key": null, "voice_over": null, "detail_raw": null, "functions": null, "native_id": 22424 } ], "next": null, "previous": null }