Upscrape
Sign in Get an API key

TikTok Ad Library scraper API

Search TikTok's public Commercial Content Library for ads and advertisers.

Ad libraries 2 capabilities 100.0% success rate
Sign in to run this LLM brief

What people use it for

  • Monitor competitor creative campaigns
  • Research advertiser activity by market
  • Build ad transparency datasets

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Search Ads

tiktok-adlibrary.ad.search
10 credits / request

Searches the TikTok Commercial Content Library by keyword. Returns raw ad payloads including creative, advertiser, run dates, targeted countries, and disclosed reach. Supports country and date-range filtering.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"country":"ALL","limit":5,"query":"nike"},"capability":"tiktok-adlibrary.ad.search"}'

Sample response

{
  "items": [
    {
      "audit_status": "1",
      "estimated_audience": "0-1K",
      "first_shown_date": 1784237607000,
      "id": "1870908557528450",
      "image_urls": [
        "https://p16-common-sign.tiktokcdn.com/tos-useast2a-i-photomode-euttp/6fe919413e04491ebaad8b42f3b28f2e~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=4381176f&x-expires=1784433600&x-signature=VDYFS7aoTNB6HCjfeSq029kzl2k%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
        "https://p16-common-sign.tiktokcdn.com/tos-useast2a-i-photomode-euttp/b49835fb967d42d78df3607de90a33c0~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=9fa9a59d&x-expires=1784433600&x-signature=2FFqMIchqpmseL2%2BNCkE%2BKyE0UQ%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
        "https://p16-common-sign.tiktokcdn.com/tos-useast2a-i-photomode-euttp/f7a12687beda49b3b6cb8b2384970e8a~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=976c4ed6&x-expires=1784433600&x-signature=VeULfXlH%2FpHWPz%2Bvt8KiEWo5beM%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1"
      ],
      "impression": 0,
      "last_shown_date": 1784237607000,
      "name": "niketarase",
      "rejection_info": null,
      "show_mode": 2,
      "sor_audit_status": "1",
      "spent": "",
      "type": "2",
      "videos": []
    },
    {
      "audit_status": "1",
      "estimated_audience": "0-1K",
      "first_shown_date": 1784235284000,
      "id": "1870906107749890",
      "image_urls": [],
      "impression": 0,
      "last_shown_date": 1784235284000,
      "name": "nikestuehm",
      "rejection_info": null,
      "show_mode": 1,
      "sor_audit_status": "1",
      "spent": "",
      "title": "#fy #outfitinspo ",
      "type": "2",
      "videos": [
        {
          "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0037-euttp/oAyg0LDjMGUSslIqGgJGAd6UQeWJefGI7CQ7hG~tplv-noop.image?dr=18692&refresh_token=e4e2ae00&x-expires=1784436176&x-signature=OyLg7mkhC2okYwI9S9aPBUWr%2Biw%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v26044gc0000d9cgqh7og65t7gqakb80",
          "video_url": "https://library.tiktok.com/api/v1/cdn/1784414564/video/[redacted:token]=/ca7a4095-f156-460d-aa35-dd501559f340?a=475769&bt=1076&btag=e000b0000&bti=PDU2NmYwMy86&ft=.NpOcInz7ThU9mDGXq8Zmo&l=202607190642443BE23421D2A879120ACD&mime_type=video_mp4&rc=[redacted:token]%3D%3D&signature=VN18s06%2BqgqmGrVYhkSfI1FVfBEz5yrJ4CjrdR0nSpc%3D&vvpl=1"
        }
      ]
    },
    {
      "audit_status": "1",
      "estimated_audience": "0-1K",
      "first_shown_date": 1784230236000,
      "id": "1870900817485890",
      "image_urls": [],
      "impression": 0,
      "last_shown_date": 1784230236000,
      "name": "pedroting1104",
      "rejection_info": null,
      "show_mode": 1,
      "sor_audit_status": "1",
      "spent": "",
      "title": "Nike Phantom Luna #FootballBoots #SoccerCleats #PhantomLuna #NikeFootball #Nike",
      "type": "2",
      "videos": [
        {
          "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-no1a-p-0037-no/o8WWQNZElKV3BIjESBFqAJFDgvkm0FvnfiVCde~tplv-noop.image?dr=18692&refresh_token=371560b4&x-expires=1784436182&x-signature=FO8A8q%2FtUU1zdv1jMJEgjn6D5bg%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v24025gl0000d9b2ck7og65u6imtqmng",
          "video_url": "https://library.tiktok.com/api/v1/cdn/1784414564/video/[redacted:token]/f8d2de26-869b-4abd-b9e3-414a624b2ace?a=475769&bt=1429&btag=e000b8000&bti=PDU2NmYwMy86&ft=.NpOcInz7ThU9mDGXq8Zmo&l=202607190642443BE23421D2A879120ACD&mime_type=video_mp4&rc=[redacted:token]%3D%3D&signature=[redacted:token]%3D&vvpl=1"
        }
      ]
    }
  ],
  "next_cursor": "0:5:",
  "total_items": 5
}

Input

Field Type Required Description
country string optional ISO-3166 alpha-2 country code, or "ALL" for all available regions (default: ALL). The library covers EU/UK/EEA regions.
cursor string optional Pagination cursor from a previous response's next_cursor.
end_date string optional Only ads shown on or before this date (YYYY-MM-DD). Default: today.
limit integer optional Maximum number of ads to return (default: 50).
query string required Search keyword or phrase (brand, product, slogan).
start_date string optional Only ads shown on or after this date (YYYY-MM-DD). Default: 30 days ago.

List Advertiser Ads

tiktok-adlibrary.advertiser-ads.list
10 credits / request

Lists every ad run by a specific TikTok advertiser, identified by its exact registered entity name (e.g. "NIKE Retail B.V."). Returns raw ad payloads with country and date-range filtering.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"advertiser_name":"NIKE Retail B.V.","business_id":"6876453864464188162","country":"ALL","limit":5},"capability":"tiktok-adlibrary.advertiser-ads.list"}'

Sample response

{
  "items": [
    {
      "audit_status": "1",
      "estimated_audience": "10K-100K",
      "first_shown_date": 1784414137000,
      "id": "1867527511007425",
      "image_urls": [
        "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/ogREjeAtINjGgRVCzXODfDObq8AFB3fAXwzUQ8~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=d5e69546&x-expires=1784433600&x-signature=a0k0Y7aTccQQKpNO%2FdfR%2FSAC3b8%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1"
      ],
      "impression": 0,
      "last_shown_date": 1784414137000,
      "name": "NIKE Retail B.V.",
      "rejection_info": null,
      "show_mode": 1,
      "sor_audit_status": "1",
      "spent": "",
      "title": "RIP THE SCRIPT | När du litar på magkänslan så äger du matchen.",
      "type": "2",
      "videos": [
        {
          "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/ogREjeAtINjGgRVCzXODfDObq8AFB3fAXwzUQ8~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=d5e69546&x-expires=1784433600&x-signature=a0k0Y7aTccQQKpNO%2FdfR%2FSAC3b8%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
          "video_url": "https://library.tiktok.com/api/v1/cdn/1784414613/video/[redacted:token]==/a7c72ee8-a80f-4e64-ba5e-90e49644a430?a=475769&bt=447&btag=e00088000&bti=PDU2NmYwMy86&ft=.NpOcInz7Th_DmDGXq8Zmo&l=202607190643337C9505A7BAEE8115E8B0&mime_type=video_mp4&rc=[redacted:token]%3D%3D&signature=k%2BinTF%2B7NgK0TpmWyiWvEKK8eIcqsqYHJ971C9fQCDA%3D&vvpl=1"
        }
      ]
    },
    {
      "audit_status": "1",
      "estimated_audience": "100K-200K",
      "first_shown_date": 1784414137000,
      "id": "1869061192805506",
      "image_urls": [
        "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/okGeiGgPfAIT3nJvCDNqUgBWWEBQFDDLxlIQiq~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=7ddcfd5b&x-expires=1784433600&x-signature=T8LGLVQyJjf2L3WPAiEV6r7FM%2Bw%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1"
      ],
      "impression": 0,
      "last_shown_date": 1784414137000,
      "name": "NIKE Retail B.V.",
      "rejection_info": null,
      "show_mode": 1,
      "sor_audit_status": "1",
      "spent": "",
      "title": "RIP THE SCRIPT | Haaland och Tatum mediterar. Vänta och se.",
      "type": "2",
      "videos": [
        {
          "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/okGeiGgPfAIT3nJvCDNqUgBWWEBQFDDLxlIQiq~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=7ddcfd5b&x-expires=1784433600&x-signature=T8LGLVQyJjf2L3WPAiEV6r7FM%2Bw%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
          "video_url": "https://library.tiktok.com/api/v1/cdn/1784414613/video/[redacted:token]==/9634b697-5d15-42f2-86db-10b00e4fd9ff?a=475769&bt=380&btag=e000b8000&bti=PDU2NmYwMy86&ft=.NpOcInz7Th_DmDGXq8Zmo&l=202607190643337C9505A7BAEE8115E8B0&mime_type=video_mp4&rc=[redacted:token]%3D%3D&signature=M%2BmJqQtDnVNUNGSHURjpsO3zh5Mv1M%2BnGm%2Fl4IegKpQ%3D&vvpl=1"
        }
      ]
    },
    {
      "audit_status": "1",
      "estimated_audience": "500K-600K",
      "first_shown_date": 1784414137000,
      "id": "1867527511009505",
      "image_urls": [
        "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o0mpoAfxEgBHeIIUYULeDCAnkJ6y0iETbBGBGX~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=cb219e04&x-expires=1784433600&x-signature=CqitZ%2FBHO6XcwBdyFYeUUdRsX%2Fg%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1"
      ],
      "impression": 0,
      "last_shown_date": 1784414137000,
      "name": "NIKE Retail B.V.",
      "rejection_info": null,
      "show_mode": 1,
      "sor_audit_status": "1",
      "spent": "",
      "title": "RIP THE SCRIPT | När du litar på magkänslan så äger du matchen.",
      "type": "2",
      "videos": [
        {
          "cover_img": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o0mpoAfxEgBHeIIUYULeDCAnkJ6y0iETbBGBGX~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=cb219e04&x-expires=1784433600&x-signature=CqitZ%2FBHO6XcwBdyFYeUUdRsX%2Fg%3D&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1",
          "video_url": "https://library.tiktok.com/api/v1/cdn/1784414613/video/[redacted:token]==/cff7634f-016d-4ff2-9bad-19931ed48648?a=475769&bt=270&btag=e000b8000&bti=PDU2NmYwMy86&ft=.NpOcInz7Th_DmDGXq8Zmo&l=202607190643337C9505A7BAEE8115E8B0&mime_type=video_mp4&rc=[redacted:token]%3D%3D&signature=RkrhFF0HCitXpBCbQJ%2BLeys3XPJeBJtFFgVO%2B6rCDjw%3D&vvpl=1"
        }
      ]
    }
  ],
  "next_cursor": "0:5:",
  "total_items": 5
}

Input

Field Type Required Description
advertiser_name string required The advertiser's exact registered entity name as shown in the TikTok Commercial Content Library (e.g. "NIKE Retail B.V."). Resolve names via the library's advertiser suggestions; matching is exact.
business_id string optional TikTok advertiser business id (adv_biz_ids). Optional: carried through for parity with the upstream request; the filter is driven by advertiser_name.
country string optional ISO-3166 alpha-2 country code, or "ALL" for all available regions (default: ALL).
cursor string optional Pagination cursor from a previous response's next_cursor.
end_date string optional Only ads shown on or before this date (YYYY-MM-DD). Default: today.
limit integer optional Maximum number of ads to return (default: 50).
start_date string optional Only ads shown on or after this date (YYYY-MM-DD). Default: 30 days ago.

Related scrapers

Facebook Ad Library Google Ads Transparency

Run TikTok Ad Library in under a minute

Sign in, create an API key, and try any capability in the playground before you write code.

Get an API key