{"uid":"cap_VrVlGS56MYhJcB7TWdHzt","slug":"stablesocial-tiktok-ad-library-search-29ebd745","name":"StableSocial TikTok Ad Library Search","description":"Scrape Creators · TikTok — Ad Library Search","url":"https://stablesocial.dev/api/sc/tiktok/ad-library/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"likes":{"enum":["top_1_20","top_21_40","top_41_60","top_61_80","top_81_100"],"type":"string","description":"Likes percentile filter."},"limit":{"type":"number","description":"Number of ads to return, max 50. Defaults to 20."},"query":{"type":"string","description":"Optional keyword to search ad titles/content."},"cursor":{"type":"number","description":"Page number to fetch. Use the cursor returned from the previous response, like 3 for page 3."},"period":{"enum":["7","30","180"],"type":"string","description":"Time window for Top Ads."},"region":{"enum":["DZ","AR","AU","AT","AZ","BH","BD","BY","BE","BO","BR","BG","KH","CA","CL","CO","CR","HR","CY","CZ","DK","DO","EC","EG","EE","FI","FR","DE","GR","GT","JO","HU","ID","IQ","IE","IL","IT","JP","KZ","KE","KW","LV","LB","MY","MX","MA","NL","NZ","NG","NO","OM","PK","PA","PY","PE","PH","PL","PT","PR","QA","LT","RO","SA","RS","SG","SK","SI","ZA","KR","ES","LK","SE","CH","TW","TH","TR","AE","GB","US","UY","VN"],"type":"string","description":"Country code. Defaults to US."},"duration":{"enum":["under_10s","10_20s","20_30s","30_40s","40_50s","over_50s"],"type":"string","description":"Video duration filter."},"industry":{"enum":["apparel_accessories","appliances","apps","baby_kids_maternity","beauty_personal_care","business_services","ecommerce_non_app","education","financial_services","food_beverage","games","health","home_improvement","household_products","life_services","news_entertainment","pets","sports_outdoor","tech_electronics","travel","vehicle_transportation"],"type":"string","description":"Industry filter."},"order_by":{"enum":["for_you","impression","play_2s_rate","play_6s_rate","cvr","ctr","like"],"type":"string","description":"Sort metric. Defaults to for_you."},"ad_format":{"enum":["spark_ads","non_spark_ads"],"type":"string","description":"Ad format filter."},"objective":{"enum":["app_installs","conversions","lead_generation","product_sales","reach","traffic","video_views"],"type":"string","description":"Campaign objective filter."},"ad_language":{"enum":["en","es","ar","vi","th","de","id","pt","fr","ms","nl","ja","it","ro","zh-Hant","ko"],"type":"string","description":"Ad language filter."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_facK20SKyyM_1UmSkAXwj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches TikTok's Ad Library to retrieve ad creatives, advertiser info, and campaign data matching specified query parameters","exampleAgentPrompt":"Search TikTok's Ad Library for ads related to 'fitness supplements' and show me what brands are advertising, their ad creatives, and any campaign details you can find.","exampleUseCases":[{"title":"Competitor ad intelligence for brands","prompt":"Look up what ads Nike is currently running on TikTok — I want to see their creatives, messaging, and how long those ads have been active."},{"title":"Niche market ad research","prompt":"Search TikTok's Ad Library for ads in the 'meal kit delivery' space and pull back everything you can find — who's advertising, what they're saying, and what formats they're using."},{"title":"Political or advocacy ad monitoring","prompt":"Find any TikTok ads running right now related to 'climate change' and tell me which advertisers are behind them and what their ads look like."}],"resultDescription":"Returns a list of TikTok ad library entries matching the search query, including ad creatives (video/image thumbnails), advertiser names, ad IDs, impression date ranges, regions targeted, and any available performance or spend signals exposed by TikTok's public Ad Library.","failureModes":["No results returned if query keyword is too niche or has no active ads","TikTok Ad Library may throttle or block scraping resulting in empty or partial results","Region-specific ads may not appear if region filter is misspecified","Stale data if TikTok's Ad Library hasn't refreshed recently","Rate limiting or payment failure returning HTTP 402 if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need programmatic access to TikTok's Ad Library for competitive intelligence, ad creative research, or brand monitoring at scale. Prefer it over manual browsing of TikTok's Ad Library UI when you need structured data for downstream analysis or when automating competitor ad tracking workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:09:22.911Z","isFirstParty":false}