Actions129
- TikTok Actions
- Profile
- Profile Videos
- Profile Followers
- Profile Following
- Profile Region
- Profile Audience
- Live Stream
- User Search
- Search Videos
- Hashtag Search
- Video
- Comments
- Replies
- Transcript
- Trending Feed
- Song
- Music Videos
- Shop Product Search
- Shop Store Products
- Shop Product
- Shop Product Reviews
- Profile Showcase Products
- Ad Library Ad
- Ad Library Search
- Twitter Actions
- Telegram Actions
- Linktree Actions
- Hacker News Actions
- Truth Social Actions
- Facebook Actions
- Google Actions
- Instagram Actions
- Threads Actions
- LinkedIn Actions
- Reddit Actions
- Spotify Actions
- YouTube Actions
- Web Actions
- Account Actions
TikTok → Ad Library Search
AI-generatedSummary
Search TikTok's Ad Library or Top Ads by applying various filters and retrieve advertising data with optional pagination to return all available results.
Inputs
- Return All — Boolean flag to determine whether to fetch all pages of results by paginating or just the first page. Pagination consumes additional API credits.
- Region — Country code filter to specify the region for Top Ads results. Defaults to 'US'.
- Period — Time window in days (7, 30, or 180) to filter Top Ads by recency.
- Query — Optional keyword to search ad titles and content.
- Advertiser Name — Search the public TikTok Ads Library by advertiser name. Using this option returns results from the public Ads Library instead of Top Ads.
- Order By — Metric by which to sort Top Ads results, such as 'for-you', 'impression', 'ctr', etc. Defaults to 'for-you'.
- Industry — Industry category to filter Top Ads.
- Objective — Campaign objective filter for Top Ads, such as 'app-installs', 'conversions', or 'lead-generation'.
- Duration — Video duration filter for Top Ads (ranges from under 10s to over 50s).
- Likes — Likes percentile filter to target Top Ads by engagement.
- Ad Format — Filter ads by format: 'Spark Ads' or 'Non Spark Ads'.
- Ad Language — Language filter for Top Ads.
Output shape
a list of ad records from TikTok's Ad Library or Top Ads according to the specified filters and pagination settings
Output contains pages of ads; pagination is controlled by the 'Return All' parameter which, if true, fetches all pages iteratively using the API's cursor-based pagination until no more pages exist. Using advertiserName parameter switches the search from Top Ads to the public Ads Library endpoint.