Logo SearchApi

TikTok Ads Library Ad Details API

GET   /api/v1/search?engine=tiktok_ads_library_ad_details
OpenAPI Initiative Download OpenAPI Spec

This API returns detailed information for a single ad in the TikTok Ads Library, including creative assets (video, cover image and images), advertiser details, the landing page link, targeting (location, age, gender), audience size, and impression data. format reports whether TikTok declares the ad as video or image. Video ads often repeat their cover image in image_urls. Use format, not image_urls, to tell an image or carousel ad from a video ad. Some ads return no creative at all. Ads that TikTok serves in its enhanced display mode (EU-targeted ads) also include the call to action, the advertising objective and, where TikTok reports them, extended targeting such as countries and provinces plus impression breakdowns by age and gender inside each impressions_by_region entry.

API Parameters

Search Params

  • Name
    ad_id
    Required
    Required
    Description

    The unique identifier of the TikTok Ad. You can obtain this from the TikTok Ads Library API results (the id field of each ad).

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_ad_details.

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

Ad Detail Response

Ad Detail Response
GET
https://www.searchapi.io/api/v1/search?ad_id=1862453421119025&engine=tiktok_ads_library_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_ads_library_ad_details",
  "ad_id": "1862453421119025"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_RqXLK4ZloPW8ikWgxM8z2jE9",
    "status": "Success",
    "created_at": "2026-09-02T08:42:33Z",
    "request_time_taken": 3.59,
    "parsing_time_taken": 0.09,
    "total_time_taken": 3.68,
    "request_url": "https://library.tiktok.com/ads/detail/?ad_id=1862453421119025",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_RqXLK4ZloPW8ikWgxM8z2jE9.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_RqXLK4ZloPW8ikWgxM8z2jE9"
  },
  "search_parameters": {
    "engine": "tiktok_ads_library_ad_details",
    "ad_id": "1862453421119025"
  },
  "ad": {
    "id": "1862453421119025",
    "advertiser": {
      "id": "7599665283850305543",
      "name": "Apple Scooter",
      "registry_location": "United States",
      "sponsor": "Apple Scooter",
      "advertiser_token": "eyJpZCI6Ijc1OTk2NjUyODM4NTAzMDU1NDMiLCJuYW1lIjoiQXBwbGUgU2Nvb3RlciJ9"
    },
    "format": "video",
    "display_mode": "standard",
    "first_shown_datetime": "2026-04-15T00:00:00Z",
    "last_shown_datetime": "2026-04-21T00:00:00Z",
    "video_link": "https://library.tiktok.com/api/v1/cdn/1788338556/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS9jNjBkYjA4Yzc5YzZmMDJkODZlMGVmN2VmNGIzY2Q0Ni82YTk4MzVlNi92aWRlby90b3MvYWxpc2cvdG9zLWFsaXNnLXZlLTAwNTFjMDAxLXNnL29NekdMS05uUFp5clNkZjRnQUVmSWVReEFmZTlPUkF3UE1HdEFFLw==/659691c8-0310-4021-b9c9-e701a5ee956c?a=475769&bt=957&btag=e000b0000&bti=PDU2NmYwMy86&ft=.NpOcInz7Thi9dZGXq8Zmo&l=2026090216423633B7B2EFE3ACF1C43171&mime_type=video_mp4&rc=ZDloOTYzNWZnNGQ2Mzs2OkBpamxtcXI5cjw3OjMzODYzNEA2NV5fNjI0NjYxYTVfXy1gYSM0MTNiMmRjL2NhLS1kMDFzcw%3D%3D&signature=IUhMdjzOih1hDNqmR7bcjqNLMrYu23zYtnego8Xe8gw%3D&vvpl=1",
    "cover_image": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oYPghRKOMAFATbtgyQ7f8FkAxxeMeXlfPAMfaZ~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=5ef195a2&x-expires=1788357600&x-signature=fO1try0HRhwcQ3tpSS60foE8kRc%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
    "image_urls": [
      "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oYPghRKOMAFATbtgyQ7f8FkAxxeMeXlfPAMfaZ~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=5ef195a2&x-expires=1788357600&x-signature=fO1try0HRhwcQ3tpSS60foE8kRc%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1"
    ],
    "external_link": "https://www.scooterorlando.com?utm_campaign=tiktok_ads_a1246828-6dbe-4990-a245-287acf37c0f7&utm_medium=video_ad&utm_source=tiktok",
    "estimated_audience": "0-1K",
    "estimated_audience_min": 0,
    "estimated_audience_max": 1000,
    "targeting": {
      "location": {
        "total_region": 1,
        "total_impressions": "0-1K",
        "impressions_by_region": [
          {
            "region": "GB",
            "impressions": "0-1K"
          },
          ...
        ]
      },
      "age": [
        {
          "region": "GB",
          "13-17": false,
          "18-24": true,
          "25-34": true,
          "35-44": true,
          "45-54": true,
          "55+": true
        },
        ...
      ],
      "gender": [
        {
          "region": "GB",
          "female": true,
          "male": true,
          "unknown": true
        },
        ...
      ],
      "target_audience_size": "24.8M-30.3M",
      "target_audience_size_min": 24800000,
      "target_audience_size_max": 30300000,
      "audience_list": "No"
    }
  }
}

Enhanced Ad Detail Response

GET
https://www.searchapi.io/api/v1/search?ad_id=1858623506579714&engine=tiktok_ads_library_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_ads_library_ad_details",
  "ad_id": "1858623506579714"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_0E6M9wDPgb74HNEoRnqybBAj",
    "status": "Success",
    "created_at": "2026-09-02T08:42:36Z",
    "request_time_taken": 3.49,
    "parsing_time_taken": 0.0,
    "total_time_taken": 3.49,
    "request_url": "https://library.tiktok.com/ads/detail/?ad_id=1858623506579714",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_0E6M9wDPgb74HNEoRnqybBAj.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_0E6M9wDPgb74HNEoRnqybBAj"
  },
  "search_parameters": {
    "engine": "tiktok_ads_library_ad_details",
    "ad_id": "1858623506579714"
  },
  "ad": {
    "id": "1858623506579714",
    "advertiser": {
      "id": "7606690572493078545",
      "name": "Tesorine Shop",
      "registry_location": "Italy",
      "sponsor": "Tesorine Shop",
      "advertiser_token": "eyJpZCI6Ijc2MDY2OTA1NzI0OTMwNzg1NDUiLCJuYW1lIjoiVGVzb3JpbmUgU2hvcCJ9"
    },
    "title": "Vi aspettiamo sul nostro shop.",
    "format": "video",
    "display_mode": "enhanced",
    "first_shown_datetime": "2026-03-03T00:00:00Z",
    "last_shown_datetime": "2026-03-04T00:00:00Z",
    "video_link": "https://library.tiktok.com/api/v1/cdn/1788338560/video/aHR0cHM6Ly92MTZtLnRpa3Rva2Nkbi5jb20vYWUwZjFjM2I4MTFlNWRhNDliNzg3NTEyYmI5OWIxMjAvNmE5ODM1ZjcvdmlkZW8vdG9zL3VzZWFzdDJhL3Rvcy11c2Vhc3QyYS12ZS0wMDUxYzc5OS1ldXR0cC9vMGRRVUlyMGdBaFZCRGg4TkZmT2RwREJTRnBqcUVESmZVWExnTS8=/ec41a2df-2703-46df-b63f-ad4a84827151?a=475769&bt=947&btag=e000b8000&bti=PDU2NmYwMy86&ft=.NpOcInz7Th8DdZGXq8Zmo&l=202609021642397E069B071021BEACE87D&mime_type=video_mp4&rc=ZDxpNmQzZTNkNDRmNjppZUBpanhoc2o5cmx3OTMzODYzNEAwMV81YzFfNjQxNF9gMjMtYSNeNm1kMmRzZGZhLS1kMDFzcw%3D%3D&signature=xXtxL6vUH%2Br5nD4F9s61hp2u1O9myxndT87PFLgC%2Bhk%3D&vvpl=1",
    "cover_image": "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oc6l1eeQas2jCQxIdFXmA1eMAeAoMGZ981lMdC~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=cd10d404&x-expires=1788357600&x-signature=hUZwhGFzw0g8EVbawzXrSNRoukc%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
    "image_urls": [
      "https://p19-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oc6l1eeQas2jCQxIdFXmA1eMAeAoMGZ981lMdC~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=cd10d404&x-expires=1788357600&x-signature=hUZwhGFzw0g8EVbawzXrSNRoukc%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1"
    ],
    "external_link": "https://ysjcmg-t5.myshopify.com?utm_campaign=tiktok_ads_5c4f8ccc-7ec6-46bd-800c-7e0d683b0039&utm_medium=video_ad&utm_source=tiktok",
    "call_to_action": "Acquista ora",
    "advertising_objective": "Sales",
    "estimated_audience": "0-1K",
    "estimated_audience_min": 0,
    "estimated_audience_max": 1000,
    "targeting": {
      "location": {
        "total_region": 20,
        "total_impressions": "0-1K",
        "impressions_by_region": [
          {
            "region": "PL",
            "impressions": "0-1K",
            "breakdowns": [
              {
                "age": "18-24",
                "gender": "MALE"
              },
              ...
            ]
          },
          ...
        ]
      },
      "age": [
        {
          "region": "PL",
          "13-17": false,
          "18-24": true,
          "25-34": true,
          "35-44": true,
          "45-54": true,
          "55+": true
        },
        ...
      ],
      "gender": [
        {
          "region": "PL",
          "female": true,
          "male": true,
          "unknown": true
        },
        ...
      ],
      "target_audience_size": "283.4M-346.3M",
      "target_audience_size_min": 283400000,
      "target_audience_size_max": 346300000,
      "audience_list": "No",
      "countries": [
        "PL",
        ...
      ],
      "operating_systems": [
        "ALL",
        ...
      ]
    }
  }
}

Image and Carousel Ad Response

Image and Carousel Ad Response
GET
https://www.searchapi.io/api/v1/search?ad_id=1869642167577618&engine=tiktok_ads_library_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_ads_library_ad_details",
  "ad_id": "1869642167577618"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_9YXGkBJ1pQDvHqJ3PLOKqQNA",
    "status": "Success",
    "created_at": "2026-09-08T01:51:43Z",
    "request_time_taken": 4.73,
    "parsing_time_taken": 0.14,
    "total_time_taken": 4.87,
    "request_url": "https://library.tiktok.com/ads/detail/?ad_id=1869642167577618",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_9YXGkBJ1pQDvHqJ3PLOKqQNA.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_9YXGkBJ1pQDvHqJ3PLOKqQNA"
  },
  "search_parameters": {
    "engine": "tiktok_ads_library_ad_details",
    "ad_id": "1869642167577618"
  },
  "ad": {
    "id": "1869642167577618",
    "advertiser": {
      "id": "7596491138706571265",
      "name": "ELEGANCIA SHOP",
      "registry_location": "France",
      "sponsor": "SHOP ELEGANCE",
      "advertiser_token": "eyJpZCI6Ijc1OTY0OTExMzg3MDY1NzEyNjUiLCJuYW1lIjoiRUxFR0FOQ0lBIFNIT1AifQ=="
    },
    "title": "Shop deals now",
    "format": "image",
    "display_mode": "enhanced",
    "first_shown_datetime": "2026-07-03T00:00:00Z",
    "last_shown_datetime": "2026-07-29T00:00:00Z",
    "image_urls": [
      "https://p19-common-sign.tiktokcdn.com/tos-no1a-i-t5fjg24jzw-no/e53cb869d52e43d2816f08c14782b0fb~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=7f89f3a5&x-expires=1788850800&x-signature=172CM7lSPgIyUknvvNPPKFDoT10%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
      "https://p16-common-sign.tiktokcdn.com/tos-no1a-i-t5fjg24jzw-no/60321f801d0c4bdbbd4bf05d36558538~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=4c2c17c8&x-expires=1788850800&x-signature=1hQZpK%2Fr2v0JpgD1bB4aVITFrhM%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
      ...
    ],
    "advertising_objective": "Sales",
    "estimated_audience": "0-1K",
    "estimated_audience_min": 0,
    "estimated_audience_max": 1000,
    "targeting": {
      "location": {
        "total_region": 1,
        "total_impressions": "0-1K",
        "impressions_by_region": [
          {
            "region": "FR",
            "impressions": "0-1K",
            "breakdowns": [
              {
                "age": "18-24",
                "gender": "MALE",
                "impressions": "0-1K"
              },
              {
                "age": "18-24",
                "gender": "FEMALE",
                "impressions": "0-1K"
              },
              {
                "age": "18-24",
                "gender": "UNKNOWN",
                "impressions": "0-1K"
              },
              {
                "age": "25-34",
                "gender": "MALE",
                "impressions": "0-1K"
              },
              {
                "age": "25-34",
                "gender": "FEMALE",
                "impressions": "0-1K"
              },
              {
                "age": "25-34",
                "gender": "UNKNOWN",
                "impressions": "0-1K"
              },
              {
                "age": "35-44",
                "gender": "MALE",
                "impressions": "0-1K"
              },
              {
                "age": "35-44",
                "gender": "FEMALE",
                "impressions": "0-1K"
              },
              {
                "age": "35-44",
                "gender": "UNKNOWN",
                "impressions": "0-1K"
              },
              {
                "age": "45-54",
                "gender": "MALE",
                "impressions": "0-1K"
              },
              {
                "age": "45-54",
                "gender": "FEMALE",
                "impressions": "0-1K"
              },
              {
                "age": "45-54",
                "gender": "UNKNOWN",
                "impressions": "0-1K"
              },
              {
                "age": "55+",
                "gender": "MALE",
                "impressions": "0-1K"
              },
              {
                "age": "55+",
                "gender": "FEMALE",
                "impressions": "0-1K"
              },
              {
                "age": "55+",
                "gender": "UNKNOWN",
                "impressions": "0-1K"
              }
            ]
          }
        ]
      },
      "age": [
        {
          "region": "FR",
          "13-17": false,
          "18-24": true,
          "25-34": true,
          "35-44": true,
          "45-54": true,
          "55+": true
        }
      ],
      "gender": [
        {
          "region": "FR",
          "female": true,
          "male": true,
          "unknown": true
        }
      ],
      "target_audience_size": "21.4M-26.1M",
      "target_audience_size_min": 21400000,
      "target_audience_size_max": 26100000,
      "audience_list": "No",
      "countries": [
        "FR"
      ],
      "operating_systems": [
        "ALL"
      ]
    }
  }
}