# TikTok Ads Scraper API

Each successful request will cost you **`5`** API credits.

You have to send a GET request to **`http://api.scrapingdog.com/tiktok/ads`** with the below-given parameters.

### Parameters

#### Scrapingdog Parameters

| Parameter                                                          | Description                                                                                     |
| ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| <p>api\_key<br></p><p><mark style="color:red;">required</mark></p> | <p>Your personal API key. Available on your dashboard <br><br>Type: <strong>String</strong></p> |

#### Search Query

| Parameter      | Description                                                                                                      |
| -------------- | ---------------------------------------------------------------------------------------------------------------- |
| query          | <p>The keyword you want to search for on TikTok Ads.<br><br>Type: <strong>String</strong></p>                    |
| advertiser\_id | <p>The unique advertiser ID to search for ads from specific advertiser.<br><br>Type: <strong>String</strong></p> |

#### Geographic Location and Localization

| Parameter | Description                                                                                                                                       |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| country   | <p>The parameter specifies the country you want to search from. <br><br>Default Value: <code>all</code><br><br>Type - <strong>String</strong></p> |

#### Filters

| Parameter    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| time\_period | <p>Defines the date range for ad results. Enter a custom range in <code>YYYY-MM-DD..YYYY-MM-DD</code> format.</p><p><br>If no range is provided, results from the past 12 months are returned by default.<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                                                                                                             |
| sort\_by     | <p>Defines how the ad results should be sorted. Supported values:<br></p><ul><li><code>last\_shown\_date\_newest\_to\_oldest</code></li><li><code>last\_shown\_date\_oldest\_to\_newest</code></li><li><code>published\_date\_newest\_to\_oldest</code></li><li><code>published\_date\_oldest\_to\_newest</code></li><li><code>unique\_users\_seen\_low\_to\_high</code></li><li><code>unique\_users\_seen\_high\_to\_low</code></li></ul><p><br><br>Default Value: <code>last\_shown\_date\_newest\_to\_oldest</code><br><br>Type: <strong>String</strong></p> |
| query\_type  | <p>Specifies how the search query should be interpreted when fetching TikTok ads.<br><br>Supported values:<br><br><code>1</code> - Searches ads by keyword or text query. Use this when you want to find ads related to a specific brand name, product, topic, or phrase.<br><br><code>2</code> - Searches ads by advertiser. Use this when the query is intended to match advertiser-related results instead of general ad keywords.<br><br>Default Value: <code>1</code><br><br>Type: <strong>String</strong></p>                                             |

#### Pagination

| Parameter         | Description                                                                                                |
| ----------------- | ---------------------------------------------------------------------------------------------------------- |
| next\_page\_token | <p>The next\_page\_token is used to get the next page of results.<br><br>Type: <strong>String</strong></p> |

### API Example

{% tabs %}
{% tab title="cURL" %}

```bash
cURL "https://api.scrapingdog.com/tiktok/ads?query=Nike&api_key=APIKEY"
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

api_key = "APIKEY"
url = "https://api.scrapingdog.com/tiktok/ads"

params = {
    "api_key": api_key,
    "query": "Nike"
}

response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Request failed with status code: {response.status_code}")

```

{% endtab %}

{% tab title="Node JS" %}

```javascript
const axios = require('axios');

const api_key = 'APIKEY';
const url = 'https://api.scrapingdog.com/tiktok/ads/';

const params = {
  api_key: api_key,
  query: 'Nike'
};

axios
  .get(url, { params: params })
  .then(function (response) {
    if (response.status === 200) {
      const data = response.data;
      console.log(data)
    } else {
      console.log('Request failed with status code: ' + response.status);
    }
  })
  .catch(function (error) {
    console.error('Error making the request: ' + error.message);
  });

```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

// Set the API key and request parameters
$api_key = 'APIKEY';
$query = 'Nike';

// Set the API endpoint
$url = 'https://api.scrapingdog.com/tiktok/ads/?api_key=' . $api_key . '&query=' . $query;

// Initialize cURL session
$ch = curl_init($url);

// Set cURL options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Execute the cURL request
$response = curl_exec($ch);

// Check if the request was successful
if ($response === false) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    // Process the response data as needed
    echo $response;
}

// Close the cURL session
curl_close($ch);

```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require 'net/http'
require 'uri'

# Set the API key and request parameters
api_key = 'APIKEY'
query = 'Nike'

# Construct the API endpoint URL
url = URI.parse("https://api.scrapingdog.com/tiktok/ads/?api_key=#{api_key}&query=#{query}")

# Create an HTTP GET request
request = Net::HTTP::Get.new(url)

# Create an HTTP client
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true # Enable SSL (https)

# Send the request and get the response
response = http.request(request)

# Check if the request was successful
if response.is_a?(Net::HTTPSuccess)
  puts response.body # Process the response data as needed
else
  puts "HTTP request failed with code: #{response.code}, message: #{response.message}"
end

```

{% endtab %}

{% tab title="Java" %}

```java
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        try {
            // Set the API key and request parameters
            String apiKey = "APIKEY";
            String query = "Nike";

            // Construct the API endpoint URL
            String apiUrl = "https://api.scrapingdog.com/tiktok/ads/?api_key=" + apiKey
                    + "&query=" + query

            // Create a URL object from the API URL string
            URL url = new URL(apiUrl);

            // Open a connection to the URL
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();

            // Set the request method to GET
            connection.setRequestMethod("GET");

            // Get the response code
            int responseCode = connection.getResponseCode();

            if (responseCode == 200) {
                // Read the response from the connection
                BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuilder response = new StringBuilder();

                while ((inputLine = reader.readLine()) != null) {
                    response.append(inputLine);
                }
                reader.close();

                // Process the response data as needed
                System.out.println(response.toString());
            } else {
                System.out.println("HTTP request failed with response code: " + responseCode);
            }

            // Close the connection
            connection.disconnect();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

```

{% endtab %}
{% endtabs %}

### API Response

```json
{
    "data": [
        {
            "id": "1864106349749377",
            "name": "kuranikerimden",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777750585000,
            "last_shown_date": 1777750585000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8xMjY0NTVmODdkMTAyMDk3YWUwMmEzOGVkMzg1NzkzZC82OWY3YTBmNy92aWRlby90b3MvYWxpc2cvdG9zLWFsaXNnLXB2ZS0wMDM3YzAwMS9vVXZCaVdES0ZDU2E5Y3BPTFJmMEFCYkVDZ01RSVVnZmdwTER6RS8=/7d665922-6e22-4412-b9ba-f2c3dea376f2?a=475769&bt=466&btag=e000b0000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=N2VkOTRmaWdoZWY1ZWhlaUBpMzxyamo5cjllOjMzODczNEAtMF5hYGE1XjIxLl8zMF8yYSNhb2AtMmRrZW5hLS1kMTFzcw%3D%3D&signature=N40Pm3kmcjGbUYVESe2N%2FSKS2nc%2BpAEHEUDsc96PKVk%3D&vvpl=1",
                    "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o8m0mpwfvAI1n4HAFBI0BKAauiAqiCtNBSMItw~tplv-noop.image?dr=18692&refresh_token=c40cf2bc&x-expires=1777836279&x-signature=ikMH2jIMsLsIBK6gCrZloUBaWuk%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v14044g50000d7qbh6nog65g0gcor9d0"
                }
            ],
            "estimated_audience": "-",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1864085325416705",
            "name": "nikeathome",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777730466000,
            "last_shown_date": 1777730466000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8yZjg1NGQ3MmQxYjY2M2JkNjMwNDhmMjM0N2MwM2IzYS82OWY3YTBlZS92aWRlby90b3MvYWxpc2cvdG9zLWFsaXNnLXB2ZS0wMDM3YzAwMS9vZzFJSUNpR2trdVJqYjAxQUpCQUVEZnhJOTB3UUFqQ0dWaXB2Yy8=/e68ebcc7-65e7-49ad-b391-8f2a25e74731?a=475769&bt=449&btag=e000b0000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=ODU4ZWllOWk2aTdoZzlmaEBpM3U3c2s5cmtuOjMzODczNEA1MWE1YjQ2Xi0xMTVhYC8xYSMuZDJyMmRrM25hLS1kMWBzcw%3D%3D&signature=wqgh%2BWN7I1fiBglbYcm0rB%2B9DM2w3GpGVkfS46QP%2FEw%3D&vvpl=1",
                    "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oEsqN2aIeSjkGgegjCLTAhvGAI4knDdpeo6IhH~tplv-noop.image?dr=18692&refresh_token=14c7335b&x-expires=1777836270&x-signature=vOm%2BaQHgDShBhXP4lhl8HSfc8js%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v1c044g50000d7qk6hnog65hup54gr10"
                }
            ],
            "estimated_audience": "0-1K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1864077889081729",
            "name": "nikesk87",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777680000000,
            "last_shown_date": 1777680000000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8xYWNkODdiMzUwZGZkMTU5OWZkNjI3N2RhYWEwZWU5YS82OWY3YTExZi92aWRlby90b3MvdXNlYXN0MmEvdG9zLXVzZWFzdDJhLXZlLTAwNjgtZXV0dHAvbzgzUndlaXY4TE9oSTFtb0VFSUI1SlFJQmZBaGlEUXprQmlwdkUv/367798bb-bdd9-4f27-95bc-13a6506f8fdc?a=475769&bt=1582&btag=e00090000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=NGc1Zjw4ZTg7NTppNTg8O0Bpam1sNGo5cjN4OjMzZjczNUA2YjQyL2A1NTExYTZgNjYtYSNvNjQ0MmRzNW5hLS1kMTNzcw%3D%3D&signature=e%2FOdM5sHCEdIRoxGoSuBM0ZyLrmi75DZYvboiWMIQ3c%3D&vvpl=1",
                    "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/oonoDfzEBD7pi68EB1i5voIjeBmIO3kQwpRiIA~tplv-noop.image?dr=18692&refresh_token=fd2a033b&x-expires=1777836319&x-signature=1d4D6L8EHmAzvquRb3qx%2BP9Y3IU%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v26044gc0000d7qu80vog65g717i9jrg"
                }
            ],
            "estimated_audience": "0-1K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863902181458946",
            "name": "kuranikerimden",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777507200000,
            "last_shown_date": 1777593600000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8wNzI3MTg2NDljNjhjYTIyOWM5NzYyNzI2ODE4OTgyMC82OWY3YTExZi92aWRlby90b3MvYWxpc2cvdG9zLWFsaXNnLXB2ZS0wMDM3YzAwMS9vY3VSblFjQnBCSzN4cEFpaUlpWjFBSUNFQnN6ZmVVZzBSRVBUSy8=/0079385a-d82f-4b78-b7e8-5e4bd228daad?a=475769&bt=1177&btag=e00088000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=Z2RnOzZlZmc4NTw6ODVmO0BpM2tqZ3E5cjhsOjMzODczNEBfMS02M182XmAxNjFeMWFiYSNrLjIuMmRjZW1hLS1kMWBzcw%3D%3D&signature=o1Ho5v6KbkvDUz6tB3pHBuy3Dtn2IFEEBLL8ObMqEnw%3D&vvpl=1",
                    "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o4cAeuqRxICsEK0BipZgKRB3iKfEABLxzIHzAS~tplv-noop.image?dr=18692&refresh_token=af3c1298&x-expires=1777836319&x-signature=mxNBAZq6HiAZQOv2%2BQBnnIiK4O0%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v1c044g50000d7pih5fog65n1d5g1hn0"
                }
            ],
            "estimated_audience": "-",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863767932681442",
            "name": "alnike86",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777420800000,
            "last_shown_date": 1777593600000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS81ZTlhOTk2ZTgzN2E0NDRiYWZhNmQzODBlOWVmYjViMC82OWY3YTEwOS92aWRlby90b3MvbWFsaXZhL3Rvcy1tYWxpdmEtdmUtMDA2OGM3OTktdXMvb0FRcDdRREJJREJFQnI2QmZFQWdFMXVGQ291c25ZTXlTV2ZSU2ov/a74e88ea-bd1f-4d1f-9b54-f328682651b1?a=475769&bt=383&btag=e00088000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=NTc3aDg7aDkzNzNlNDU1ZEBpM2Y7bnc5cmU7OjMzZzczNEBjMjRiXjUzXy4xLmA0NTVhYSNgLy1jMmQ0bWthLS1kMS9zcw%3D%3D&signature=k3BYsqBrRJk5ezs4zdP%2Bb2krzbjqNvijmtPahreAg6E%3D&vvpl=1",
                    "cover_img": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/o4R9kLGRjIHeegDZl6IQAlCANDEAG19I3TegxO~tplv-noop.image?dr=18692&refresh_token=15a34786&x-expires=1777836297&x-signature=P59jnQqKEpan5d089f61ZQkAL28%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v12044gd0000d7n8pb7og65tfk082cc0"
                }
            ],
            "estimated_audience": "0-1K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863767932681426",
            "name": "alnike86",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777420800000,
            "last_shown_date": 1777593600000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8zOWYxYjcyZWYyNjczMzU3MGZlZjIxMjdmMDI2M2NkMS82OWY3YTExOS92aWRlby90b3MvbWFsaXZhL3Rvcy1tYWxpdmEtdmUtMDA2OGM3OTktdXMvb2dMcTVHZ251QXBmT2k1Z0l5dmUzRzlGSUtkZUlldVNSaFFBUUcv/8c58c4f5-406f-4c91-b304-ec214832df4b?a=475769&bt=479&btag=e00088000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=OTg3O2g2ZTxnNjo8Ozs2NkBpM2toOXY5cnFpOjMzZzczNEBiXy4vMi8xNjYxYV4yMmAvYSMxc3NoMmQ0XmthLS1kMS9zcw%3D%3D&signature=dE4UGO5fewDavXpXNMsJehikn4sy4mK20ZKJE1nMAmo%3D&vvpl=1",
                    "cover_img": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/oUVuY4KzRgfIg19EGDnAvFfdQXG9ApfgfOrYd0~tplv-noop.image?dr=18692&refresh_token=73414ac9&x-expires=1777836313&x-signature=4c%2Bs%2BBSXDcpLBzlnKDYkLFJ8Nzo%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v12044gd0000d7nfan7og65sk6vevh40"
                }
            ],
            "estimated_audience": "0-1K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863891557827906",
            "name": "nikegiu2",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777507200000,
            "last_shown_date": 1777593600000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS83ZTk1MjBiNzQ3MzgwNDAxMzFiMWRmNjI1NjEwYjQwNy82OWY3YTExZC92aWRlby90b3Mvbm8xYS90b3Mtbm8xYS12ZS0wMDY4LW5vL29JRTBPUlJFSUZBZnFFbnpRcHFnZGVwVmtCRjRnRDhEd3VENWdnLw==/62943314-58da-422e-9a7a-943a65a51f1c?a=475769&bt=2534&btag=e00088000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=ODw3Zjo5PGY0NGQ1ZDdmZ0BpM2p2ZWo5cmhqOjMzbzczNUAuXmEwYzYzX2ExMi1hX2EzYSNjaWheMmRjcG1hLS1kMTFzcw%3D%3D&signature=FGMTZGH1L6TrwawfKX4yfNiGZcmsJsKmnonDoRyjvIc%3D&vvpl=1",
                    "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-no1a-p-0037-no/oUOz5gg8fAEoY4bTCDRpdnBeDEFkFElVpwSI3g~tplv-noop.image?dr=18692&refresh_token=d0b836ce&x-expires=1777836317&x-signature=R9s12FMSAhbbrId%2Fjl06vz%2B2UU0%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v24044gl0000d7pgsefog65gabkslgf0"
                }
            ],
            "estimated_audience": "10K-100K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863836516205570",
            "name": "nikeelopes",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777420800000,
            "last_shown_date": 1777507200000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8zZDNmYTQ1NGMwYjUyYWRjZDQ0NTVjZTAzNzllY2JkZS82OWY3YTBmYi92aWRlby90b3MvdXNlYXN0MmEvdG9zLXVzZWFzdDJhLXZlLTAwNjhjMDAxLWV1dHRwL280SDhtSUZFRFlpUW1CWmtRRWZCQXpRWE5GZktEcERDTHJyVkd5Lw==/96dab186-6b3b-447d-b7c1-c6bcbd011aa7?a=475769&bt=1163&btag=e000b8000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=NTdnaWk2ZmczOjg3MzY7PEBpajczbG85cjQ5OjMzZjgzNUBeX2IuLy9hXzMxYS0yNjQxYSNpb2dzMmRjNW1hLS1kLzNzcw%3D%3D&signature=NtS6ofQD2u0pp4PRrtXX%2B1Dz4MoQpRpGO8uMKs0lv2U%3D&vvpl=1",
                    "cover_img": "https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/oMQfrAfKm8IFrZVPCFQYINFEdpOkJpyADiDmBp~tplv-noop.image?dr=18692&refresh_token=eeb800a9&x-expires=1777836283&x-signature=4ewzEpf%2FMzI2JpbYCgZIcNR%2FBAI%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v26025gc0000d7p681fog65lvij0r4lg"
                }
            ],
            "estimated_audience": "10K-100K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863789544208402",
            "name": "adhamnike",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777420800000,
            "last_shown_date": 1777507200000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS81NDljMzM2ZDg2NjQzNTU1YmM1YmNkMGM2ODAxMjMwNi82OWY3YTBmMy92aWRlby90b3Mvbm8xYS90b3Mtbm8xYS12ZS0wMDY4LW5vL284RkVUZk54TGdSUkIxQkVRZDNpQVVCa3RGZWlJVE5vcGxvY0duLw==/8dd7616a-e6b7-41fa-8749-1e8ee236c044?a=475769&bt=580&btag=e000b8000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=ZmY2NTo0OTM0NmU2ZTU8NEBpajhuZHE5cmR1OjMzbzczNUBgLTEyYS0xXjAxNGFfLmBhYSM2azBiMmRjNWxhLS1kMTFzcw%3D%3D&signature=cvYxVq3hV0L1Hp2Obk2SOnab3kbvURA%2BCyMnch9J%2Fuo%3D&vvpl=1",
                    "cover_img": "https://p19-common-sign.tiktokcdn.com/tos-no1a-p-0037-no/ocBPAtK8zFfI5EbCQpEDuEfmQD8LgQ6QFkxpXR~tplv-noop.image?dr=18692&refresh_token=24d2d861&x-expires=1777836275&x-signature=qWWBa9lBBvw%2F7vPKPLVYIieutqo%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v24044gl0000d7or8afog65nea3kn59g"
                }
            ],
            "estimated_audience": "1K-10K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863767932682434",
            "name": "alnike86",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777420800000,
            "last_shown_date": 1777507200000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS82NTdjMmZkYmQzZTgwYTQwNDczYzc1OTdhOGFkY2Y0NC82OWY3YTEzNi92aWRlby90b3MvdXNlYXN0NS90b3MtdXNlYXN0NS1wdmUtMDA2OC10eC9vd3JjR2R4RTRBUjVnSUFRWEJGcEFmSERncVNhUURaVmZuN0UyNS8=/7ccb8d38-1fb9-446a-9beb-2d672d65cc0b?a=475769&bt=836&btag=e00090000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=OjM6O2QzOzlnN2VkMzc0NEBpam9tO3Y5cms6OjMzZzczNEBiYC5fYl4uX2AxXy41NmMvYSNuajBrMmRrbGthLS1kMS9zcw%3D%3D&signature=31H4dm%2F%2Bk%2BHuV7vU3zQ8%2FCe2oV8Cv6D5%2FN00vp3Nlqk%3D&vvpl=1",
                    "cover_img": "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oUDcPSHGQB275IEEQfRfED5D1xGqngrADdA1Fp~tplv-noop.image?dr=18692&refresh_token=ade68156&x-expires=1777836342&x-signature=koHwGGSHoTlgkaid9VLWotIdDiQ%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v12044gd0000d7n7ohnog65sn83jmlqg"
                }
            ],
            "estimated_audience": "0-1K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863767932681458",
            "name": "alnike86",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777420800000,
            "last_shown_date": 1777507200000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS9jZTFmODc3NTQ3ZDk5MDlmMTViNzIzMTE0MTczY2YxOC82OWY3YTEwNS92aWRlby90b3MvbWFsaXZhL3Rvcy1tYWxpdmEtdmUtMDA2OGM3OTktdXMvb0VDbmxVSXdwRUFpVWkwZzdRSTB5OWYxaEZCb0JBQ0VMUXgwU3Uv/11522f0f-1ea6-4ca6-8748-9465454a5ba7?a=475769&bt=617&btag=e00088000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=ZDdpZWU0Ojk3M2VkOjM0PEBpM252Z2w5cmQ7OjMzZzczNEBjNjUwXzYwXy8xM2NiY19gYSNea2A2MmRjMmthLS1kMS9zcw%3D%3D&signature=k3lzNaaI2vX3ZWcQhQH770cS3vve7CSseAgvqfh5v6o%3D&vvpl=1",
                    "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068c799-us/oIQFEpUSUBAwg1xNk0iyBI0ArCLw0At9Infdui~tplv-noop.image?dr=18692&refresh_token=44cbce39&x-expires=1777836293&x-signature=LsqbBrBhw7lzZZxHMrgvCejP4B8%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v12044gd0000d7n85afog65i9dcsnka0"
                }
            ],
            "estimated_audience": "0-1K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        },
        {
            "id": "1863737585640610",
            "name": "rinikelani",
            "audit_status": "1",
            "type": "2",
            "first_shown_date": 1777334400000,
            "last_shown_date": 1777420800000,
            "videos": [
                {
                    "video_url": "https://library.tiktok.com/api/v1/cdn/1777814660/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8xOGY0MjQ2YTJjM2MyNWJmYmYyMWFhNGRlZGRjNzRiNi82OWY3YTBmMy92aWRlby90b3MvdXNlYXN0MmEvdG9zLXVzZWFzdDJhLXZlLTAwNjgtZXV0dHAvb012aWc4ZzBJYTdDekVmQUJ3WUJQQmxJeWJBaVFzRG9Ca00wRVcv/c99d59d0-f434-42bd-afe0-febf75e01e6e?a=475769&bt=917&btag=e000b8000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thjpr3PXq8Zmo&l=202605032124194E5A214295B599256426&mime_type=video_mp4&rc=aThoZmdpZDM4ZWQ1O2VpOkBpajQ1OHU5cnVpOjMzZjczNUA0Yy4yNTYtNjAxLi1iX2IuYSNmLWhhMmQ0MWxhLS1kMTNzcw%3D%3D&signature=Qv%2B8dymgDzDXvqQjYjAxzHvY%2FykN1cihk%2BPDQPPEg0M%3D&vvpl=1",
                    "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/okbfzEbIBg6yDA8BoiPzA4BzgiaWR0BC17lIhw~tplv-noop.image?dr=18692&refresh_token=415b8c01&x-expires=1777836275&x-signature=p3TGiQGSrxKP6xFOGL5Co03%2FbIE%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v26044gc0000d7of4r7og65rd5k201ig"
                }
            ],
            "estimated_audience": "10K-100K",
            "spent": "",
            "impression": 0,
            "show_mode": 1,
            "image_urls": [],
            "rejection_info": null,
            "sor_audit_status": "1"
        }
    ],
    "total": 1000,
    "has_more": true,
    "search_id": "202605032124194E5A214295B599256426",
    "code": 0,
    "next_page_token": "eyJzZWFyY2hfaWQiOiIyMDI2MDUwMzIxMjQxOTRFNUEyMTQyOTVCNTk5MjU2NDI2Iiwib2Zmc2V0IjoxfQ=="
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.scrapingdog.com/tiktok-scraper-api-documentation/tiktok-ads-scraper-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.