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 and cover image), advertiser details, targeting (location, age, gender), audience size, and impression data.

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_K8rA9sWqXpY7mC3nTvNfH2QJ",
    "status": "Success",
    "created_at": "2026-04-20T15:00:00Z",
    "request_time_taken": 0.83,
    "parsing_time_taken": 0.01,
    "total_time_taken": 0.84,
    "request_url": "https://library.tiktok.com/ads/detail/?ad_id=1862453421119025",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_K8rA9sWqXpY7mC3nTvNfH2QJ.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_K8rA9sWqXpY7mC3nTvNfH2QJ"
  },
  "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"
    },
    "first_shown_datetime": "2026-04-15T00:00:00Z",
    "last_shown_datetime": "2026-04-19T00:00:00Z",
    "video_link": "https://library.tiktok.com/api/v1/cdn/1776697645/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8zYzY5NTBkMTI3NzJjYjQzMzkyNWEyNWM1ZDk5MDdjZS82OWU2OTU5Ny92aWRlby90b3MvYWxpc2cvdG9zLWFsaXNnLXZlLTAwNTFjMDAxLXNnL29NekdMS05uUFp5clNkZjRnQUVmSWVReEFmZTlPUkF3UE1HdEFFLw==/35a9adf3-ff04-435a-93f9-41b5b3829c20?a=475769&br=1914&bt=957&btag=e000b0000&bti=PDU2NmYwMy86&cc=13&cd=0%7C0%7C0%7C0&ch=0&cr=0&cs=0&cv=1&dr=1&ds=1&ft=.NpOcInz7Th0VRyPXq8Zmo&l=202604202307258AD24EFAFE99595F46F0&mime_type=video_mp4&qs=0&rc=ZDloOTYzNWZnNGQ2Mzs2OkBpamxtcXI5cjw3OjMzODYzNEA2NV5fNjI0NjYxYTVfXy1gYSM0MTNiMmRjL2NhLS1kMDFzcw%3D%3D&signature=gflCuA9%2Brvsz1m7vzOIczbmQrRjV6ssgYbGnsU9L9lw%3D&vvpl=1",
    "cover_image": "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/oYPghRKOMAFATbtgyQ7f8FkAxxeMeXlfPAMfaZ",
    "image_urls": [
      "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/oYPghRKOMAFATbtgyQ7f8FkAxxeMeXlfPAMfaZ"
    ],
    "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"
    }
  }
}