Logo SearchApi

TikTok Ads Library API

GET   /api/v1/search?engine=tiktok_ads_library

The TikTok Ads Library API returns detailed information about TikTok advertisements, including the ad position, unique ID, advertiser name, date range when the ad was shown, video and cover image links, and estimated audience reach.

API Parameters

Search Params

  • Name
    q
    Required
    Optional
    Description

    Defines the keyword for your search. Use this parameter to search for ads containing specific keywords or phrases.

    If you want to search for exact match, use "" to enclose the keyword.

  • Name
    advertiser_id
    Required
    Optional
    Description

    Specifies the unique advertiser ID to search for ads from a specific advertiser.

    You can obtain the advertiser ID by:

Localization

Filters

  • Name
    time_period
    Required
    Optional
    Description

    Specifies the date range for ads. Use the format YYYY-MM-DD..YYYY-MM-DD to define a custom date range.

    If not specified, defaults to the last year from the current date.

  • Name
    sort_by
    Required
    Optional
    Description

    Specifies the sorting order for ads. Supported values:

    • last_shown_date_newest_to_oldest
    • last_shown_date_oldest_to_newest
    • published_date_newest_to_oldest
    • published_date_oldest_to_newest
    • unique_users_seen_low_to_high
    • unique_users_seen_high_to_low
    If not specified, defaults to last_shown_date_newest_to_oldest.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    A token for fetching the next set of results. You can obtain this token from the next_page_token field in the previous response

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to tiktok_ads_library.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response using q parameter

Full Response using <code>q</code> parameter
GET
https://www.searchapi.io/api/v1/search?engine=tiktok_ads_library&q=apple
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_ads_library",
  "q": "apple"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_BxR6dazVoAVkFwdA3Ewvbj9G",
    "status": "Success",
    "created_at": "2025-07-30T16:35:06Z",
    "request_time_taken": 1.48,
    "parsing_time_taken": 0.02,
    "total_time_taken": 1.5,
    "request_url": "https://library.tiktok.com/ads?region=all&start_time=1722290400000&end_time=1753826400000&sort_type=last_shown_date%2Cdesc&adv_name=apple&adv_biz_ids=&query_type=1",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_BxR6dazVoAVkFwdA3Ewvbj9G.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_BxR6dazVoAVkFwdA3Ewvbj9G"
  },
  "search_parameters": {
    "engine": "tiktok_ads_library",
    "q": "apple",
    "country": "all",
    "time_period": "2024-07-30..2025-07-30",
    "page": 1
  },
  "search_information": {
    "total_results": 1000
  },
  "ads": [
    {
      "position": 1,
      "id": "1812446344339457",
      "advertiser": "Raiffeisen Schweiz Genossenschaft ",
      "first_shown_datetime": "2024-10-22T02:00:00+02:00",
      "last_shown_datetime": "2025-07-29T02:00:00+02:00",
      "video_link": "https://library.tiktok.com/api/v1/cdn/1753893314/video/aHR0cHM6Ly92MTZtLnRpa3Rva2Nkbi5jb20vYTBlM2VkODQyMmY5YzRjMWMxYzgyMjJlOTJhNzk4MzgvNjg4YTllMmMvdmlkZW8vdG9zL3VzZWFzdDJhL3Rvcy11c2Vhc3QyYS12ZS0wMDUxYzc5OS1ldXR0cC9vVWRHYk9qWERNcElHamlzREFJZmZEdWVUVERBRExRR0ZtZ0NzUi8=/b0947524-2c2a-4955-9849-9f92048cc70e?a=475769&bti=PDU2NmYwMy86&ch=0&cr=0&dr=1&cd=0%7C0%7C0%7C0&cv=1&br=284&bt=142&cs=0&ds=1&ft=.NpOcInz7Thh.RPKXq8Zmo&mime_type=video_mp4&qs=0&rc=O2U2aTpnOjU6NzhmOWY2aUBpM3c6PHE5cm08djMzODYzNEAzMjIuXy1jX2IxMTYzX2EuYSNmYW1xMmRzLjBgLS1kMC1zcw%3D%3D&vvpl=1&l=202507310035132CF6ACABA9D84F95D549&btag=e000b0000&cc=3",
      "cover_image": "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/oAeOSmbgGAGDTNfIcGLuTIV5DsYpQACDRfAgXA",
      "estimated_audience": "100K-200K",
      "estimated_audience_min": 100000,
      "estimated_audience_max": 200000
    },
    ...
  ],
  "pagination": {
    "next_page_token": "eyJzZWFyY2hfaWQiOiIyMDI1MDczMTAwMzUxMzJDRjZBQ0FCQTlEODRGOTVENTQ5Iiwib2Zmc2V0IjoxfQ=="
  }
}

Full Response using advertiser_id parameter

Full Response using <code>advertiser_id</code> parameter
GET
https://www.searchapi.io/api/v1/search?advertiser_id=6952423671851909889&engine=tiktok_ads_library
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_ads_library",
  "advertiser_id": "6952423671851909889"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_Rz4KNQmOp60YHL67oyWl8DBv",
    "status": "Success",
    "created_at": "2025-07-30T16:43:08Z",
    "request_time_taken": 1.64,
    "parsing_time_taken": 0.02,
    "total_time_taken": 1.66,
    "request_url": "https://library.tiktok.com/ads?region=all&start_time=1722290400000&end_time=1753826400000&sort_type=last_shown_date%2Cdesc&adv_name=LIDL+ROMANIA&adv_biz_ids=6952423671851909889&query_type=2",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_Rz4KNQmOp60YHL67oyWl8DBv.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_Rz4KNQmOp60YHL67oyWl8DBv"
  },
  "search_parameters": {
    "engine": "tiktok_ads_library",
    "advertiser_id": "6952423671851909889",
    "country": "all",
    "time_period": "2024-07-30..2025-07-30",
    "page": 1
  },
  "search_information": {
    "total_results": 254
  },
  "ads": [
    {
      "position": 1,
      "id": "1833536575637633",
      "advertiser": "LIDL ROMANIA SRL",
      "first_shown_datetime": "2025-06-02T02:00:00+02:00",
      "last_shown_datetime": "2025-07-29T02:00:00+02:00",
      "video_link": "https://library.tiktok.com/api/v1/cdn/1753893795/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS9lY2RiYzAzOTM2NTZmYTQwNDA0ZWU2MDcyZTEwZTZjZS82ODhhYTAxMS92aWRlby90b3MvdXNlYXN0MmEvdG9zLXVzZWFzdDJhLXZlLTAwNTFjNzk5LWV1dHRwL29jMWFna1BxUUVwdGZnUUJYOG9EeURFQk9JcTJRT2JmZ0FDRlpOLw==/7ca93baa-af9f-49c3-a5b9-df8d2d1275be?a=475769&bti=PDU2NmYwMy86&ch=0&cr=0&dr=1&cd=0%7C0%7C0%7C0&cv=1&br=556&bt=278&cs=0&ds=1&ft=.NpOcInz7ThFzRPKXq8Zmo&mime_type=video_mp4&qs=0&rc=MzQ7PDZlNTU3ZDNnZWg5OUBpamt4bnU5cjVxMzMzODYzNEAyYWI2LzJfX2ExYl5jLS1iYSNrMzMtMmRrZXBhLS1kMC1zcw%3D%3D&vvpl=1&l=202507310043157D8DDBE7F2F4F59C20BB&btag=e000b0000&cc=13",
      "cover_image": "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/oUpyaCgES2NtBQDIWBFoAeZDgqQt8BsCfXODOk",
      "estimated_audience": "600K-700K",
      "estimated_audience_min": 600000,
      "estimated_audience_max": 700000
    },
    ...
  ],
  "pagination": {
    "next_page_token": "eyJzZWFyY2hfaWQiOiJleUpzWVhOMFgzTnZjblFpT2xzeE56VTBNalkxTmpBd0xDSXpOamM0TkRrNE56Z3pNRGMwTkRBMUlsMHNJbTVsZUhSZlkzVnljMjl5SWpveE1uMD0iLCJvZmZzZXQiOjF9"
  }
}