Video
commerce.videoUnifiedYakındaEtiketlediği ürünler ve sağladığı satışlarla birlikte alışveriş yapılabilen kısa video.
birincil anahtar platform + video ID'siPost ile aynı4 planlanan çağrıŞu anda 3 Direct uç noktası
4 çağrı planlıYakında
Çağrılar, e-ticaret API tasarımının 0.1.0-draft sürümünden alındı ve REST yolları olarak yazıldı. Her çağrı bu varlığı, listelediği platformlarda tek bir yapıda döndürür; hiçbiri henüz devreye alınmadı.
- GET
/Bir videonun izlenmeleri, etkileşimi, satışları ve GMV'siTikTok ShopTasarlandıv1/ e-commerce/ tiktok-shop/ videos/ {videoId} - GET
/Videoları içerik üreticisine, ürüne, kategoriye, izlenmeye ve yayın tarihine göre filtrelerTikTok ShopTasarlandıv1/ e-commerce/ tiktok-shop/ videos/ search - GET
/İzlenmeye veya satışa göre günlük, haftalık ya da aylık video sıralamalarıTikTok ShopTasarlandıv1/ e-commerce/ tiktok-shop/ videos/ rankings - GET
/Bir videonun 180 güne kadar günlük anlık görüntüleriTikTok ShopKaynak bekleniyorv1/ e-commerce/ tiktok-shop/ videos/ trends
Alan sözleşmesinde 58 alanTasarım 0.1.0-draft · listing-contract-v3.2
Tasarımın tanımladığı alan anahtarları ve her değerin nasıl yazıldığı. Yalnızca bir kaynağın gerçekten döndürdüğü alanlar gelir.
Kimlik5
AIsa ID'si, platform, site ve platformun kendi ID'sientity.iduuidentity.kindstringentity.platformstringentity.scopestringvideo.native_idstring
Profil19
Platformun onun hakkında yayımladığı ayrıntılarvideo.descriptionstringvideo.dynamic_cover_urlurlvideo.play_urlurlvideo.download_urlurlvideo.download_url_no_watermarkstringvideo.duration_secondsdecimalvideo.width_pixelsdecimalvideo.height_pixelsdecimalvideo.ad_period_daysdecimal
10 alan daha gösterDaha az göster
video.resolutionstringvideo.file_size_rawstringvideo.published_at_rawjsonvideo.is_commercial_rawjsonvideo.is_ad_rawjsonvideo.is_ai_generated_rawjsonvideo.ad_source_rawjsonvideo.has_comments_rawjsonvideo.hashtags_rawjsonvideo.commentsobject[]
Sayfa2
Başlık, bağlantı, görseller ve sayfada gösterilenlerurlurlimage.cover_urlurl
Metrikler27
Satışlar, GMV ve etkileşim, her biri kaynağının dönemindemetrics.sales_countdecimalmetrics.gmvdecimalmetrics.video_view_countdecimalmetrics.video_gpm_reporteddecimalmetrics.sales_count_30ddecimalmetrics.gmv_30ddecimalmetrics.product_count_reporteddecimalmetrics.gmv_growth_rate_reporteddecimalmetrics.video_like_to_follower_ratio_reporteddecimal
18 alan daha gösterDaha az göster
metrics.video_gpm_30ddecimalmetrics.video_view_count_1ddecimalmetrics.video_view_count_7ddecimalmetrics.video_view_count_30ddecimalmetrics.video_like_count_1ddecimalmetrics.video_like_count_7ddecimalmetrics.video_like_count_30ddecimalmetrics.video_engagement_rate_reporteddecimalmetrics.video_like_to_view_ratio_reporteddecimalmetrics.ad_view_count_reporteddecimalmetrics.ad_view_share_reporteddecimalmetrics.ad_gmv_share_reporteddecimalmetrics.ad_roas_reporteddecimalmetrics.ad_cpa_reporteddecimalmetrics.video_like_countdecimalmetrics.video_comment_countdecimalmetrics.video_share_countdecimalmetrics.video_favorite_countdecimal
Bağlantılar4
İşaret ettiği varlıkların AIsa ID'lerirelated.listing_performanceobject[]related.listingsuuid[]related.shopsuuid[]relation.creator_iduuid
Bağlam1
Tüm para alanlarının kullandığı para birimicontext.currencystring
decimal ve integer değerler, hassasiyeti korumak için dize olarak gelir. _reported ile biten bir anahtar kaynağın kendi rakamıdır ve hesaplama yöntemi doğrulanmamıştır; _raw kaynağın ham kodunu korur. uuid alanları diğer AIsa varlıklarını gösterir.
Bugün Direct üzerinden çağırınYayında
Bu tür nesneyi zaten döndüren sağlayıcı uç noktaları, sağlayıcının kendi biçiminde. Kodunuz sağlayıcıyı adıyla belirtir; sağlayıcı değiştirmek kodu değiştirmek anlamına gelir.
1 API'den 3 uç nokta · $0.001 ve üzeri
| API | Metot | Yol | Uç nokta | Fiyat |
|---|---|---|---|---|
| TikHub | POST | tikhub/tiktok/creator/get_product_related_videos | tiktok get_product_related_videos | $0.001 ve üzeri |
| TikHub | POST | tikhub/tiktok/creator/get_video_associated_product_list | tiktok get_video_associated_product_list | $0.001 ve üzeri |
| TikHub | POST | tikhub/tiktok/creator/get_video_to_product_stats | tiktok get_video_to_product_stats | $0.001 ve üzeri |
Video ile bağlantılı varlıklar
Her bağlantı, aynı çağrıda isteyebileceğiniz bir alandır.
Post
platform + gönderi ID'siTek platformdaki bir gönderi, bağlantısı ve metrikleriyle.
Creator
platform + içerik üreticisi ID'siSatış ortaklığı bağlantılarıyla satış yapan bir içerik üreticisi.
Listing
pazaryeri + ürün sayfası ID'siTek pazaryerindeki tek ürün sayfası: fiyat, sıralama, değerlendirmeler ve satışlar.
Shop
pazaryeri + satıcı ID'siTek pazaryerindeki bir satıcı hesabı.