TikTok Ads API | PandorLabs

GET/v1/tiktok/ad-library/search

Search ads

1 request

Searches TikTok ads, either broadly with query or for one advertiser with advertiser_name; send exactly one of them. An advertiser search first matches the name against TikTok's advertiser suggestions, then queries that advertiser entity and tags each ad with adv_biz_ids. To lock onto the precise advertiser behind a See all ads link, add its adv_biz_ids alongside advertiser_name; TikTok disregards the ID unless the name is also sent. When no advertiser entity matches, the API uses TikTok's plain name search instead. Results cover all regions, are ordered by latest shown date, paginate by cursor, and each ad links to its public TikTok ad page.

Query parameters

`query` string	Free-text ad search. Send this or advertiser_name, never both.
`advertiser_name` string	Advertiser to search for, matched to TikTok's advertiser entity with name search as the fallback. Send this or query, never both.
`adv_biz_ids` string	Advertiser business ID taken from a See all ads link, used with advertiser_name to pin one advertiser. Sending it without advertiser_name returns 400.
`cursor` string	Opaque cursor from the previous response.

curl "https://api.pandorlabs.com/v1/tiktok/ad-library/search" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "source": "tiktok_public_ads_library",
  "advertiser_name": "Gymshark",
  "resolved_advertiser_name": "GYMSHARK LTD",
  "advertiser_matches": [
    {
      "name": "GYMSHARK LTD",
      "ids": "7078923208527618049"
    }
  ],
  "ads": [
    {
      "id": "1871655924410641",
      "url": "https://library.tiktok.com/ads/detail/?ad_id=1871655924410641",
      "name": "GYMSHARK LTD",
      "adv_biz_ids": "7078923208527618049",
      "audit_status": "1",
      "type": "2",
      "first_shown_date": 1784937600000,
      "last_shown_date": 1785024000000,
      "videos": [
        {
          "video_url": "https://library.tiktok.com/api/v1/cdn/...",
          "cover_img": "https://p16-common-sign.tiktokcdn.com/..."
        }
      ],
      "estimated_audience": "1K-10K",
      "spent": "",
      "impression": 0,
      "show_mode": 1,
      "image_urls": [],
      "rejection_info": null,
      "sor_audit_status": "1"
    }
  ],
  "total": 62344,
  "has_more": true,
  "cursor": "opaque cursor for the next page"
}

GET/v1/tiktok/ad-library/ad

Ad details

1 request

Returns a single TikTok ad given its ID or URL. It covers both TikTok Top Ads and transparency ads with one response shape; fields TikTok does not publish for an ad come back null, empty, or false.

Query parameters

ad_id

stringrequired

Accepts a TikTok ad ID or a link to the ad.

curl "https://api.pandorlabs.com/v1/tiktok/ad-library/ad?ad_id=1869335220395266" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "ad_title": "I thought this was a gimmick until I tried it! A wrinkled shirt, one button, and a few minutes later... ready to wear. Tap the link in bio and see why everyone’s talking about Bellairon before it sells out. @Bellairon LLC ",
  "brand_name": "",
  "comment": 1,
  "cost": 1,
  "country_code": [
    "TR"
  ],
  "ctr": 0.5,
  "favorite": false,
  "has_summary": false,
  "highlight_text": "",
  "id": "7646829987799334920",
  "industry_key": "label_22108000000",
  "is_search": false,
  "keyword_list": null,
  "landing_page": "https://www.amazon.com/dp/B0DRTC8XBW?ref=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&ref_=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&social_share=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&oas=true&utm_source=tiktok&utm_medium=paid&utm_id…",
  "like": 92,
  "objective_key": "campaign_objective_reach",
  "objectives": [
    {
      "label": "campaign_objective_reach",
      "value": 5
    }
  ],
  "pattern_label": [],
  "share": 1,
  "source": "Others",
  "source_key": 73,
  "video_info": {
    "vid": "v12044gd0000d8erq07og65h1cq991gg",
    "duration": 89.767,
    "cover": "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068c799-us/oIbqBdvfEAiFpgvAOgrQHCF5R0mkDDLiEfvQDS~tplv-noop.image?dr=18692&refresh_token=2cdb79e2&x-expires=1781231880&x-signature=W%2BBTq1VGRRaNnIuMGUpWWSgmOoo%3D&t=9276707c&ps=14f1eb3e&s…",
    "video_url": {
      "540p": "https://v16m-default.tiktokcdn.com/3e7ec770348dbc627fc02ea1e8417c25/6a2b7108/video/tos/maliva/tos-maliva-ve-0068c799-us/oIN2GPIRgHAUBHOeNfLk2HBSERoJeIALGC3jAE/?a=0&bti=NTU4QDM1NGA%3D&&bt=315&ft=cApXJCz7ThWHKnz9LGZmo0P&mime_type=video_mp4&rc…",
      "720p": "https://v16m-default.tiktokcdn.com/9f16ea869602069b9fdad27dc113cb48/6a2b7108/video/tos/maliva/tos-maliva-ve-0068c799-us/ooEipQa9HbhJ4ChzASIngUPhBAdXiABIvxU2E/?a=0&bti=NTU4QDM1NGA%3D&&bt=877&ft=cApXJCz7ThWHKnz9LGZmo0P&mime_type=video_mp4&rc=…"
    },
    "width": 720,
    "height": 1280
  },
  "voice_over": false,
  "creative_center_url": "https://ads.tiktok.com/business/creativecenter/topads/7646829987799334920/pc/en",
  "detail_analysis": null,
  "interactive_time_analysis": {
    "ctr": {
      "metric": "retain_ctr",
      "analysis": [
        {
          "second": 0,
          "value": 0.048321828136158054
        }
      ],
      "duration": 91,
      "highlight": [
        1
      ],
      "percentile": 0.99
    },
    "cvr": {
      "metric": "retain_cvr",
      "analysis": [
        {
          "second": 0,
          "value": 0
        }
      ],
      "duration": 91,
      "highlight": [],
      "percentile": 0.99
    },
    "clicks": {
      "metric": "click_cnt",
      "analysis": [
        {
          "second": 0,
          "value": 0.2631578947368421
        }
      ],
      "duration": 91,
      "highlight": [
        1
      ],
      "percentile": 0.99
    },
    "conversion": {
      "metric": "convert_cnt",
      "analysis": [
        {
          "second": 0,
          "value": 0
        }
      ],
      "duration": 91,
      "highlight": [],
      "percentile": 0.99
    },
    "remain": {
      "metric": "play_retain_cnt",
      "analysis": [
        {
          "second": 0,
          "value": 1
        }
      ],
      "duration": 91,
      "highlight": [],
      "percentile": 0.99
    }
  },
  "recommended_for_you": [
    {
      "ad_title": "Adımlarınıza eğlence katmaya hazır mısınız? \"Hiç böyle çorap görmüş müydünüz?\" diyoruz ve iddiamızı ortaya koyuyoruz! Giyimkent Outlet İndirim Çadırı'nda çorap modasına yepyeni bir boyut getirdik. Sevdiğiniz popüler kültür ve kült anime ka…",
      "brand_name": "",
      "cost": 0,
      "ctr": 0.63,
      "favorite": false,
      "id": "7644102379697602567",
      "industry_key": "label_22108000000",
      "is_search": false,
      "like": 127,
      "objective_key": "campaign_objective_reach",
      "video_info": {
        "vid": "v1c044g50000d86qrfnog65v7nuvf30g",
        "duration": 13.213,
        "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/ogCtJD4GUCr8GavLIfI1jAQ9IDvNeGEAfjQgg9~tplv-noop.image?dr=18692&refresh_token=fc9b28a3&x-expires=1781231805&x-signature=zYq%2F3BQnXoM8CMFBFKDON6lhPBs%3D&t=9276707c&ps=14f1eb3e&shp=9e368…",
        "video_url": {
          "720p": "https://v16m-default.tiktokcdn.com/1342656e028b133716a1e892a89e214a/6a2b70bd/video/tos/alisg/tos-alisg-pve-0037c001/os3NtUfeIHH1ALjc3Q4IWADrx9BGCBG8IEgejj/?a=0&bti=NTU4QDM1NGA%3D&&bt=837&ft=cApXJCz7ThWHanz9LGZmo0P&mime_type=video_mp4&rc=ZDY…"
        },
        "width": 576,
        "height": 1024
      }
    }
  ]
}

Search ads	`/v1/tiktok/ad-library/search`	1 request
Ad details	`/v1/tiktok/ad-library/ad`	1 request