Skip to content
Examples

Get Results

Retrieve scraped data from TikTok Top Ads Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your TikTok Top Ads Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

internal_idstring

Unique TikTok internal identifier for the ad. Example: 7183244447446040577

urlstring

Direct URL to the ad listing in TikTok Ads Library. Example: https://ads.tiktok.com/business/creativecenter/topads/7183244447446040577

ad_titlestring

Title or headline of the TikTok advertisement. Example: Omg Top War is SOOO fun!!

brand_namestring

Name of the brand running the ad. Example: Top War: Battle Game

costinteger

Relative cost or spend level indicator of the ad. Example: 2

ctrfloat

Click-through rate (CTR) of the ad. Example: 0.16

favoriteboolean

Whether the ad is bookmarked in TikTok Ads Library. Example: false

industry_keystring

Internal key for the ad's industry category. Example: label_25310000000

industrystring

Industry category the ad belongs to. Example: Strategy

is_searchboolean

Whether this ad was returned via a search in TikTok Ads Library. Example: false

likeinteger

Number of likes the ad video received. Example: 1316378

objective_keystring

Internal key for the campaign objective. Example: campaign_objective_app_install

objectivestring

Campaign objective (e.g. App Installs, Traffic, Conversions). Example: App Installs

taginteger

Category tag assigned to the ad in TikTok Ads Library. Example: 3

video_info_vidstring

Internal TikTok identifier for the ad video. Example: v0911dg40001cen4er3c77ubsnsedsp0

video_info_durationfloat

Duration of the ad video in seconds. Example: 34.368

video_info_coverstring

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_720pstring

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_540pstring

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_widthinteger

Width of the ad video in pixels. Example: 720

video_info_heightinteger

Height of the ad video in pixels. Example: 1280

keywordsstring

Keywords associated with the ad in TikTok Ads Library

landing_pagestring

URL of the landing page the ad directs users to

shareinteger

Number of times the ad video was shared

sourcestring

Platform where the ad is served (e.g. TikTok)

commentinteger

Number of comments on the ad video

country_codejson

ISO 2-letter country code of the ad's target region

has_summaryboolean

Whether the ad has a summary section in TikTok Ads Library

highlight_textstring

Highlight or badge label shown on the ad in TikTok Ads Library

objectivesjson

List of campaign objectives associated with the ad

pattern_labeljson

Creative pattern label categorizing the ad's visual format

source_keyinteger

Internal key identifying the ad source

voice_overboolean

Whether the ad video includes a voice-over track

detail_rawjson

Raw detail data returned by the TikTok Ads Library API

Response

200
{
  "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
}