bodapi
HomeAPIsContact
LoginSign Up
bodapi

High-quality data API provider

Product

  • APIs

Support

  • Contact

Account

  • Login
  • Sign Up
© 2026 bodapi. All rights reserved.
Overview
Product
Version
Search
Endpoints
GETGet Influencer Follower List - Realtime1 credit/callGETGet Influencer Region - Realtime1 credit/callGETGet Influencer Following List - Realtime1 credit/callGETGet Influencer QR Code - Realtime1 credit/callGETGet Influencer Trends - Enriched1 credit/callGETGet Influencer Detail - Enriched1 credit/callGETGet Influencer Livestream List - Enriched1 credit/callGETGet Influencer Product List - Enriched1 credit/callGETGet Influencer Ranking List - Enriched1 credit/callGETGet Influencer Detail - Realtime1 credit/callGETGet Influencer Video List - Realtime1 credit/callGETGet Influencer List - Enriched1 credit/callGETGet Influencer Video List - Enriched1 credit/call
GETGet Shop Detail - Enriched1 credit/callGETGet Shop List - Enriched1 credit/callGETGet Shop Trends - Enriched1 credit/callGETGet Shop Product List - Enriched1 credit/callGETGet Shop Video List - Enriched1 credit/callGETGet Shop Livestream List - Enriched1 credit/callGETGet Shop Ranking List - Enriched1 credit/callGETGet Shop Influencer List - Enriched1 credit/callGETGet Shop Product List - Realtime1 credit/call
GETGet Product Detail Web - Realtime (unstable)1 credit/callGETGet Product Review List - Enriched1 credit/callGETSearch Products - Realtime1 credit/callGETGet Product Detail App - Realtime1 credit/callGETGet TikTok Shop Categories Level21 credit/callGETGet TikTok Shop Categories Level31 credit/callGETGet Product Review List - Realtime1 credit/callGETGet Product List - Enriched1 credit/callGETGet Product Detail - Enriched1 credit/callGETGet Product Influencer List - Enriched1 credit/callGETGet Product Ranking List - Enriched1 credit/callGETGet TikTok Shop Categories Level11 credit/callGETGet Product ID from Share Link - Realtime1 credit/callGETGet Product Trends - Enriched1 credit/callGETGet Product Video List - Enriched1 credit/callGETGet Product Livestream List - Enriched1 credit/call
GETInteractive time analysis - Realtime1 credit/callGETTop AD search - Realtime1 credit/callGETGet hashtag detail - Realtime1 credit/callGETGet the industry list - Realtime1 credit/callGETGet priority region - Realtime1 credit/callGETGet trend videos - Realtime1 credit/callGETGet hashtag list - Realtime1 credit/callGETGet top ads spotlight - Realtime1 credit/callGETGet top ads detail - Realtime1 credit/callGETGet top ads list - Realtime1 credit/call
GETGet Suggestions Users - Realtime1 credit/callGETGet Trending Search Term Ranking - Realtime1 credit/callGETGet Keyword Insight - Realtime1 credit/call
GETGet Music Ranking List - Realtime1 credit/callGETGet Music Video List - Realtime1 credit/callGETGet Music Detail - Realtime1 credit/callGETGet Sticker Video List - Realtime1 credit/callGETGet Sticker Detail - Realtime1 credit/call
GETGet Category Detail - Enriched1 credit/callGETGet Category Trends - Enriched1 credit/call
GETGet Video Comment Keywords - Realtime1 credit/callGETGet Video Interaction Trends - Realtime1 credit/callGETGet Influencer Milestones - Realtime1 credit/call
GETGet Top Search - Realtime1 credit/callGETSearch Product - Realtime1 credit/callGETSearch Hashtags - Realtime1 credit/callGETSearch Influencers - Realtime1 credit/callGETSearch Music - Realtime1 credit/callGETSearch Videos - Realtime1 credit/callGETSearch Live Streams - Realtime1 credit/callGETGeneral Search - Enriched1 credit/callGETImage Search Paged Product Data - Realtime1 credit/callPOSTImage Search for Products - Realtime1 credit/call
GETBatch download cover images1 credit/call
GETGet Hashtag Video List - Realtime1 credit/callGETGet Video List - Enriched1 credit/callGETGet Video Ranking List - Enriched1 credit/callGETGet Recommended Video Stream - Realtime1 credit/callGETGet Trending Hashtag - Realtime1 credit/callGETGet Video Detail - Realtime1 credit/callGETGet Video Captions - Realtime1 credit/callGETGet Video Comment List - Realtime1 credit/callGETGet Video Comment Replies - Realtime1 credit/callGETGet Video Download URL - Realtime1 credit/callGETGet Video Detail - Enriched1 credit/callGETGet Video Product List - Enriched1 credit/callGETGet Video Trends - Enriched1 credit/callGETGet HashTag Trends - Enriched1 credit/callGETGet HashTag Ranking List - Enriched1 credit/call
GETGet Live List - Enriched1 credit/callGETGet Live Detail - Enriched1 credit/callGETGet Live Trends - Enriched1 credit/callGETGet Live Product List - Enriched1 credit/callGETGet Live Stream Detail - Realtime1 credit/call
APIs/TikTok Ultra API/v1/Get top ads detail - Realtime

Get top ads detail - Realtime

GET/api/tiktok-ultra-api1/v1/api-v3-realtime-top-ads-detail1 credit/call

API Overview This realtime top ad detail endpoint retrieves the full public-facing information for a single ad material by material ID. The response includes the ad title, brand name, countries, industry, campaign objective, landing page, source, budget level, CTR, likes, comments, shares, creative highlight text, video cover, and playback URLs, making it a live detail snapshot for one ad creative.

Recommended Use Cases

  • Break down a specific ad creative in detail
  • Verify competitor landing pages and campaign setup information
  • Evaluate engagement performance, creative direction, and reusable video assets

Notes

  • Realtime endpoints may hit risk control; if the API returns code=500, keep retrying (code=500 does not consume your current usage quota)

Request Parameters

Validation rules grouped by request section.

Query Parameters

material_idstringMaterial ID,Can be obtained from /v1/tk-ads/top_ad_list, or from the TikTok Creative Center URL, e.g. https://ads.tiktok.com/business/creativecenter/topads/7469861356595134480/pc/zh?from=001110&period=180, where material_id = 7469861356595134480.7552078920880619527
Type
string
Required
Yes
Default
7552078920880619527
Example
7552078920880619527
Material ID,Can be obtained from /v1/tk-ads/top_ad_list, or from the TikTok Creative Center URL, e.g. https://ads.tiktok.com/business/creativecenter/topads/7469861356595134480/pc/zh?from=001110&period=180, where material_id = 7469861356595134480.

Header Parameters

X-Bodapi-KeystringCreate or view a key under API keys in the dashboard.
Type
string
Required
Yes
Create or view a key under API keys in the dashboard.

Request Examples

curl -X GET '/api/tiktok-ultra-api1/v1/api-v3-realtime-top-ads-detail?material_id=7552078920880619527' \
  -H "X-Bodapi-Key: $BODAPI_API_KEY"

Test This Endpoint

X-Bodapi-Key

Please sign in to use the live console.

Click "Run" to send a live request and see the response here