Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "internal_id": "<string>",
  "url": "<string>",
  "ad_title": "<string>",
  "brand_name": "<string>",
  "cost": 123,
  "ctr": 123,
  "favorite": true,
  "industry_key": "<string>",
  "industry": "<string>",
  "is_search": true,
  "like": 123,
  "objective_key": "<string>",
  "objective": "<string>",
  "tag": 123,
  "video_info_vid": "<string>",
  "video_info_duration": 123,
  "video_info_cover": "<string>",
  "video_info_video_url_720p": "<string>",
  "video_info_video_url_540p": "<string>",
  "video_info_width": 123,
  "video_info_height": 123,
  "keywords": "<string>",
  "landing_page": "<string>",
  "share": 123,
  "source": "<string>",
  "comment": 123,
  "country_code": "<any>",
  "has_summary": true,
  "highlight_text": "<string>",
  "objectives": "<any>",
  "pattern_label": "<any>",
  "source_key": 123,
  "voice_over": true,
  "detail_raw": "<any>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve scraped data from your TikTok Top Ads Scraper runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

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

​
Result Fields

Each result object contains the following fields:
​
internal_id
string
Unique TikTok internal identifier for the ad. Example: 7183244447446040577
​
url
string
Direct URL to the ad listing in TikTok Ads Library. Example: https://ads.tiktok.com/business/creativecenter/topads/7183244447446040577
​
ad_title
string
Title or headline of the TikTok advertisement. Example: Omg Top War is SOOO fun!!
​
brand_name
string
Name of the brand running the ad. Example: Top War: Battle Game
​
cost
integer
Relative cost or spend level indicator of the ad. Example: 2
​
ctr
float
Click-through rate (CTR) of the ad. Example: 0.16
​
favorite
boolean
Whether the ad is bookmarked in TikTok Ads Library. Example: false
​
industry_key
string
Internal key for the ad’s industry category. Example: label_25310000000
​
industry
string
Industry category the ad belongs to. Example: Strategy
​
is_search
boolean
Whether this ad was returned via a search in TikTok Ads Library. Example: false
​
like
integer
Number of likes the ad video received. Example: 1316378
​
objective_key
string
Internal key for the campaign objective. Example: campaign_objective_app_install
​
objective
string
Campaign objective (e.g. App Installs, Traffic, Conversions). Example: App Installs
​
tag
integer
Category tag assigned to the ad in TikTok Ads Library. Example: 3
​
video_info_vid
string
Internal TikTok identifier for the ad video. Example: v0911dg40001cen4er3c77ubsnsedsp0
​
video_info_duration
float
Duration of the ad video in seconds. Example: 34.368
​
video_info_cover
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
​
video_info_video_url_720p
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
​
video_info_video_url_540p
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
​
video_info_width
integer
Width of the ad video in pixels. Example: 720
​
video_info_height
integer
Height of the ad video in pixels. Example: 1280
​
keywords
string
Keywords associated with the ad in TikTok Ads Library
​
landing_page
string
URL of the landing page the ad directs users to
​
share
integer
Number of times the ad video was shared
​
source
string
Platform where the ad is served (e.g. TikTok)
​
comment
integer
Number of comments on the ad video
​
country_code
json
ISO 2-letter country code of the ad’s target region
​
has_summary
boolean
Whether the ad has a summary section in TikTok Ads Library
​
highlight_text
string
Highlight or badge label shown on the ad in TikTok Ads Library
​
objectives
json
List of campaign objectives associated with the ad
​
pattern_label
json
Creative pattern label categorizing the ad’s visual format
​
source_key
integer
Internal key identifying the ad source
​
voice_over
boolean
Whether the ad video includes a voice-over track
​
detail_raw
json
Raw detail data returned by the TikTok Ads Library API