Piloterr

TikTok Top Ads Ad

GET
/v2/tiktoktopads/ad

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

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Ad id or detail URL from search.

Example:

https://ads.tiktok.com/business/creativecenter/topads/7686267188656750612/pc/en?period=30

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/tiktoktopads/ad?query=string"
{  "ctr": 0.22,  "url": "https://ads.tiktok.com/business/creativecenter/topads/7686267188656750612/pc/en?period=30",  "cost": 1,  "ad_id": "7686267188656750612",  "format": "video",  "source": "TikTok Ads Manager",  "duration": 32.9,  "headline": "25% Off Our Popular Juice Groove Router Jig. Limited Time Sale!",  "countries": [    "US"  ],  "image_url": "https://p16.tiktokcdn.com/detail-cover.jpg",  "objective": "campaign_objective_conversion",  "video_url": "https://v16.tiktokcdn.com/detail.mp4",  "like_count": 39,  "objectives": [    {      "label": "campaign_objective_conversion",      "value": 3    }  ],  "voice_over": null,  "share_count": 1,  "industry_key": "label_21103000000",  "keyword_list": null,  "landing_page": "https://craftedelements.com/products/juice-groove-router-jig",  "comment_count": 0,  "advertiser_name": "crafted elements"}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}