TikTok Ad Library API: search ads and fetch ad details as JSON

You can search TikTok ads with two REST endpoints: one searches the public Ads Library by keyword or advertiser name, the other fetches a single ad by ID or URL. The ad endpoint first checks Creative Center Top Ads, then the public transparency Ads Library, and returns JSON you can store or compare. No TikTok business login is needed, and there is no cookie or browser session to keep alive. Each successful call is billed on its own, so you can test a few searches before you scale up.

Buy credits

Use cases

Research competitor creatives before launching a TikTok campaign
List all ads run by a specific advertiser
Find ads around a product keyword or niche
Save ad details for a swipe file or creative library
Feed ad copy into an LLM to spot hooks and angles
Check whether an ad you saw is still listed in the public library

Endpoints and cost

Endpoint	What it returns	Credits/call	USD/call (Freelance plan)
`/v1/tiktok/ads_ad`	Ad Library Ad	1	$0.0017
`/v1/tiktok/ads_search`	Ad Library Search	1	$0.0017

Endpoint details

`/v1/tiktok/ads_ad`

Ad Library Ad 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.

Parameter	Type	Required	Description
`ad_id`	string	yes	Creative Center Top Ads material ID or URL, or a public Ads Library ad ID or library.tiktok.com detail URL.

Sample response (trimmed):

{
 "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 everyo...",
 "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_cs...",
 "like": 92,
 "objective_key": "campaign_objective_reach",
 "objectives": [
  {
   "label": "campaign_objective_reach",
   "value": 5
  }
 ],
 "pattern_label": [],
 "share": 1,
 "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-expir...",
  "video_url": {
   "540p": "https://v16m-default.tiktokcdn.com/3e7ec770348dbc627fc02ea1e8417c25/6a2b7108/video/tos/maliva/tos-maliva-ve-0068c799-us/oIN2GPIRgHAUBHOeNfLk2HBSERoJeIALGC3jA...",
   "720p": "https://v16m-default.tiktokcdn.com/9f16ea869602069b9fdad27dc113cb48/6a2b7108/video/tos/maliva/tos-maliva-ve-0068c7

`/v1/tiktok/ads_search`

Ad Library Search 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.

Parameter	Type	Required	Description
`query`	string	no	General ad search. Provide either query or advertiser_name, not both.
`advertiser_name`	string	no	Advertiser name to resolve through TikTok's typeahead and search by advertiser entity. Falls back to TikTok's name search when no entity matches. Provide either
`adv_biz_ids`	string	no	TikTok advertiser business ID from a See all ads link. Use it with advertiser_name to pin the exact advertiser. Required companion: advertiser_name; ID-only sea
`next_cursor`	string	no	Opaque cursor returned from the previous response.

Example: curl

curl -H "X-Scapi-Key: $SCAPI_KEY" "https://api.scrapall.bipsport.com/scapi/v1/tiktok/ads_ad"

Example: Python

import os, requests
r = requests.get("https://api.scrapall.bipsport.com/scapi/v1/tiktok/ads_ad",
    headers={"X-Scapi-Key": os.environ["SCAPI_KEY"]})
print(r.json())

FAQ

Can I search TikTok ads by advertiser?

Yes. The search endpoint accepts either a general query or an advertiser_name for advertiser-specific results. You can also pass adv_biz_ids when you already know the advertiser IDs, which keeps the results focused on those accounts.

How do I fetch a single ad?

Call the ad endpoint with ad_id. It checks Creative Center Top Ads first and then the public transparency Ads Library for that ad, and returns the documented fields as JSON.

How does pagination work?

Search responses return a cursor. Pass it as next_cursor to load the next page of results, and stop when no cursor comes back.

Do I need a TikTok Ads Manager account?

No. You send your query and API key header. There is no TikTok login, cookie or business account involved.

Which fields are returned for each ad?

Only the fields documented in the endpoint reference. Check the sample response on the docs page before you depend on a specific field in your code or reports.

How do I pay and get my API key?

Open the Buy page, pick the Freelance plan and pay in USDT on TRC20 or ERC20. The key is shown once, right after the payment is confirmed on-chain.

How many credits does one call use?

The cost table on this page lists credits per call for each endpoint. The Freelance plan is $45 for 27,000 credits per 30 days.

Get an API key and credits

Full reference: all tiktok-ad-library endpoints.