Upscrape 2.0 is here. Live platform data for agents, apps, and workflows. Upscrape 2.0 is here. REST API and MCP, one connection. Explore capabilities

TikTok Ad Library scraper API

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

Ad libraries 2 capabilities 54.7% success rate
Sign in to run this Copy platform prompt

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 Endpoint docs Copy coding prompt

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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&x-expires=1784436176&x-signature=[redacted:credential]&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=[redacted:credential]&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=[redacted:credential]&x-expires=1784436182&x-signature=[redacted:credential]&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:credential]&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 Endpoint docs Copy coding prompt

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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&x-expires=1784433600&x-signature=[redacted:credential]&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=[redacted:credential]&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