Skip to main content
Network status
Log in
Piloterr
Back to library

TikTok Top Ads Search API

Search TikTok Creative Center Top Ads by region, objective, period, and keyword. Returns ad cards and pagination (1 credit).

Active1 credit = 1 requestGET/v2/tiktoktopads/search
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Search TikTok Top Ads (Creative Center). Pass a region (AR), objective id, period (7 / 30 / 180), a keyword, or a full Top Ads URL. 1 credit per call.

Each card includes the ad id, advertiser, headline, CTR, likes, and video preview. Pagination is { results, pagination }. Open results[].url with the ad endpoint for the full creative.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/tiktoktopads/search?period=30
GET https://api.piloterr.com/v2/tiktoktopads/search?period=30&region=AR
GET https://api.piloterr.com/v2/tiktoktopads/search?period=30&region=AR&objective=4

ParametersLink to Parameters

Parameter Type Required Description
query string no Full Top Ads search URL, or a keyword
keyword string no Brand / product keyword
region string no ISO country code
objective string no Campaign objective id (URL object)
period string no 7, 30 (default), or 180
order_by string no for_you, reach / impression, ctr / like
page / per_page integer no Pagination

Related endpointsLink to Related endpoints

Related APIs

Expand your data capabilities with these complementary tools.

View All
TikTok Top Ads Ad/v2/tiktoktopads/ad

Get one TikTok Creative Center Top Ad by URL or id: creative, landing page, CTR, and engagement (1 credit).

GET1 credit = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert