# Get Results

Retrieve scraped data from TikTok Top Ads Scraper

Retrieve scraped data from your **TikTok Top Ads Scraper** runs.

## Headers
<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

## Query Parameters
<ParamField query="squid" type="string" required>
  Hash of the squid to get results from
</ParamField>

<ParamField query="run" type="string">
  Hash of a specific run (optional)
</ParamField>

<ParamField query="page" type="integer">
  Page number (default: 1). Example: `1`
</ParamField>

## Result Fields
Each result object contains the following fields:

<ResponseField name="internal_id" type="string">
  Unique TikTok internal identifier for the ad. Example: `7183244447446040577`
</ResponseField>

<ResponseField name="url" type="string">
  Direct URL to the ad listing in TikTok Ads Library. Example: `https://ads.tiktok.com/business/creativecenter/topads/7183244447446040577`
</ResponseField>

<ResponseField name="ad_title" type="string">
  Title or headline of the TikTok advertisement. Example: `Omg Top War is SOOO fun!!`
</ResponseField>

<ResponseField name="brand_name" type="string">
  Name of the brand running the ad. Example: `Top War: Battle Game`
</ResponseField>

<ResponseField name="cost" type="integer">
  Relative cost or spend level indicator of the ad. Example: `2`
</ResponseField>

<ResponseField name="ctr" type="float">
  Click-through rate (CTR) of the ad. Example: `0.16`
</ResponseField>

<ResponseField name="favorite" type="boolean">
  Whether the ad is bookmarked in TikTok Ads Library. Example: `false`
</ResponseField>

<ResponseField name="industry_key" type="string">
  Internal key for the ad's industry category. Example: `label_25310000000`
</ResponseField>

<ResponseField name="industry" type="string">
  Industry category the ad belongs to. Example: `Strategy`
</ResponseField>

<ResponseField name="is_search" type="boolean">
  Whether this ad was returned via a search in TikTok Ads Library. Example: `false`
</ResponseField>

<ResponseField name="like" type="integer">
  Number of likes the ad video received. Example: `1316378`
</ResponseField>

<ResponseField name="objective_key" type="string">
  Internal key for the campaign objective. Example: `campaign_objective_app_install`
</ResponseField>

<ResponseField name="objective" type="string">
  Campaign objective (e.g. App Installs, Traffic, Conversions). Example: `App Installs`
</ResponseField>

<ResponseField name="tag" type="integer">
  Category tag assigned to the ad in TikTok Ads Library. Example: `3`
</ResponseField>

<ResponseField name="video_info_vid" type="string">
  Internal TikTok identifier for the ad video. Example: `v0911dg40001cen4er3c77ubsnsedsp0`
</ResponseField>

<ResponseField name="video_info_duration" type="float">
  Duration of the ad video in seconds. Example: `34.368`
</ResponseField>

<ResponseField name="video_info_cover" type="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`
</ResponseField>

<ResponseField name="video_info_video_url_720p" type="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`
</ResponseField>

<ResponseField name="video_info_video_url_540p" type="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`
</ResponseField>

<ResponseField name="video_info_width" type="integer">
  Width of the ad video in pixels. Example: `720`
</ResponseField>

<ResponseField name="video_info_height" type="integer">
  Height of the ad video in pixels. Example: `1280`
</ResponseField>

<ResponseField name="keywords" type="string">
  Keywords associated with the ad in TikTok Ads Library
</ResponseField>

<ResponseField name="landing_page" type="string">
  URL of the landing page the ad directs users to
</ResponseField>

<ResponseField name="share" type="integer">
  Number of times the ad video was shared
</ResponseField>

<ResponseField name="source" type="string">
  Platform where the ad is served (e.g. TikTok)
</ResponseField>

<ResponseField name="comment" type="integer">
  Number of comments on the ad video
</ResponseField>

<ResponseField name="country_code" type="json">
  ISO 2-letter country code of the ad's target region
</ResponseField>

<ResponseField name="has_summary" type="boolean">
  Whether the ad has a summary section in TikTok Ads Library
</ResponseField>

<ResponseField name="highlight_text" type="string">
  Highlight or badge label shown on the ad in TikTok Ads Library
</ResponseField>

<ResponseField name="objectives" type="json">
  List of campaign objectives associated with the ad
</ResponseField>

<ResponseField name="pattern_label" type="json">
  Creative pattern label categorizing the ad's visual format
</ResponseField>

<ResponseField name="source_key" type="integer">
  Internal key identifying the ad source
</ResponseField>

<ResponseField name="voice_over" type="boolean">
  Whether the ad video includes a voice-over track
</ResponseField>

<ResponseField name="detail_raw" type="json">
  Raw detail data returned by the TikTok Ads Library API
</ResponseField>

## Response

```json 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
}
```
