TikTok Shop API — filtreler ve sorgu parametreleri
Bu referans, aşağıdaki işlevi çağıran entegratörler içindir /api/v1/tiktok-shop/* ile API anahtarı, ya da aynı yol şekilleri altında /api/tiktok-shop/... oturum açılmış halde tarayıcı oturumu. HTTP yol listesi ve genel davranış: API kılavuzu.
Parametreler nasıl gönderilir?#
| Mekanizma |
Ayrıntılar |
| Sorgu dizesi |
GET için olağan. |
| JSON Gönder |
POST yöntemini kabul eden keşif ve sayım rotalarında, istek gövdesindeki bir JSON nesnesi sorgu parametreleriyle birleştirilir (aşağıdaki tablolardaki anahtarlarla aynıdır). Filtre kümeleri büyük olduğunda bunu kullanın (414 URI Too Long hatasını önler). |
| POST Formu |
application/x-www-form-urlencoded body de params ile birleştirilir. |
| Boş bırakıldı / boş |
Boş dize, null, ya da metin dizesi "tanımlanmamış" çıkarılır ve genellikle göz ardı edilir. |
Keşfet ve say (kategoriler, mağazalar, içerik üreticiler, videolar, ürünler)#
Bunlar şunlara karşılık gelir:
Yol son eki (altında /api/v1/tiktok-shop/) |
Amaç |
kategoriler/keşfet, kategoriler/sayısı |
Kategorileri listele veya filtrele / eşleşenleri say |
mağazalar/keşfet, mağaza sayısı |
Mağazaları listele veya ara / eşleşmeleri say |
yaratıcılar/keşfet, yazar sayısı |
Yaratıcıları listele veya ara / eşleşmeleri say |
videolar/keşfet, videolar/sayısı |
Videoları listele veya ara / eşleşmeleri say |
ürünler/keşfet, ürün sayısı |
Ürünleri listele veya ara / eşleşenleri say |
Sayfa numaralandırma ve sıralama (sadece inceleme amaçlı; sayıma dahil edilmez )
| Parametre |
Varsayılan |
Notlar |
sayfa |
1 |
Tamsayı sayfası. |
sınır |
20 |
Sayfa boyutu. |
sonra |
— |
Opak tuş seti imleci (ileri sayfa numaralandırma). |
toplam dahil |
— |
Varsa, üst katmana iletilir. |
kontrol noktası atlama |
— |
Varsa, üst katmana iletilir. |
sıralama |
Aşağıda varlık başına default_sort değerine bakın |
Upstream, döneme özgü sıralama alanlarını eşler. |
sipariş |
açıklama |
Sıralama yönü. |
Kategori kapsamı belirleme (inceleme ve sayma, ne zaman kategori_hiyerarşisi var mı (doğruysa)#
| Parametre |
Notlar |
kategori_kimlikleri |
Virgülle ayrılmış veya dizi; aşağıdaki seviye kimlikleriyle birleştirilmiş. |
kategori_l1_id, kategori_l2_id, kategori_l3_id |
Tek bir kimlik; birden fazla takma ad kategori_l1_kimlikleri, kategori_l2_kimlikleri, kategori_l3_kimlikleri bunlar da kabul edilir. |
kategori_kimliklerini_hariç_tut |
Dışarıda tutulacak, virgülle ayrılmış liste. |
| Parametre |
Varsayılan |
ülke |
ABD |
Her bir varlık, izin verilen bir filtre kümesini sunar. İstekler standart parametre adlarını kullanır; takma adlar ise alternatif adları kabul eder (aynı değer).
Kategoriler — varsayılan sıralama: gelir_kaynağı#
| Filtreler |
ülke, seviye, kategori_kimlikleri, ad, dönem, minimum gelir, maksimum gelir, mağaza başına minimum gelir, mağaza başına maksimum gelir, en_iyi_3_mağaza_oranı, en_çok_seçilen_ilk_3_mağaza_oranı, min_ilk_10_mağaza_oranı, en_çok_satılan_10_mağaza_oranı, min_mağaza_sayısı, maksimum mağaza sayısı, en az video sayısı, maksimum video sayısı |
Takma adlar: minimum gelir ← 30 günlük minimum gelir; maksimum gelir ← 30 günlük maksimum gelir.
Mağazalar — varsayılan sıralama: gelir#
| Filtreler |
ülke, ad, dönem, kategori_kimlikleri, minimum gelir, maksimum gelir, minimum gelir artış oranı, maksimum gelir artış oranı, minimum satış artış oranı, maksimum satış artış oranı, ilk kez görüldü, en düşük puan, maksimum puan, satıcı_türü, min_ürün_sayısı, maksimum ürün sayısı, min_ortalama_birim_fiyatı, maksimum ortalama birim fiyat, min_yaratıcı_sayısı, maksimum yaratıcı sayısı, en az video sayısı, maksimum video sayısı, kendi kendine işletilen kanal stratejisi yüzdesi, kendi kendine işletilen kanal stratejisi yüzdesi |
Takma adlar: minimum gelir ← 30 günlük minimum GMV; maksimum gelir ← 30 günlük maksimum brüt satış tutarı; minimum gelir artış oranı ← 30 günlük minimum GMV büyüme oranı; maksimum gelir artış oranı ← 30 günlük maksimum GMV büyüme oranı; min_ortalama_birim_fiyatı ← min_ortalama_fiyat; maksimum ortalama birim fiyat ← maksimum ortalama fiyat.
Yaratıcılar — varsayılan sıralama: gelir#
| Filtreler |
ülke, ad, dönem, kategori_kimlikleri, minimum gelir, maksimum gelir, minimum gelir artış oranı, maksimum gelir artış oranı, min_takipçi_artış_oranı, maksimum takipçi artış oranı, min_görüntüleme_artış_oranı, maksimum görüntüleme artış oranı, min_takipçi, maksimum takipçi sayısı, en az görüntüleme sayısı, maksimum görüntüleme sayısı, doğrulanmış, min_ürün_sayısı, maksimum ürün sayısı, en az video sayısı, maksimum video sayısı |
Takma adlar: minimum gelir ← 30 günlük minimum GMV; maksimum gelir ← 30 günlük maksimum brüt satış tutarı.
Videolar — varsayılan sıralama: gelir#
| Filtreler |
ülke, ad, dönem, kategori_kimlikleri, minimum gelir, maksimum gelir, minimum gelir artış oranı, maksimum gelir artış oranı, min_görüntüleme_artış_oranı, maksimum görüntüleme artış oranı, min_beğeni_artış_oranı, maksimum beğeni artış oranı, min_hisse_büyüme_oranı, maksimum hisse artış oranı, en az görüntüleme sayısı, maksimum görüntüleme sayısı, min_süre, maksimum süre, min_ROAS, maksimum ROAS, minimum reklam harcaması, maksimum reklam harcaması, en az beğeni, maksimum beğeni sayısı, min_yaratıcı_takipçileri, maksimum_yaratıcı_takipçisi, yayın tarihi, is_ad, is_affiliate, kendini tanıtma, is_ai_ugc, gelir_eğilimi |
Ürünler — varsayılan sıralama: gelir#
| Filtreler |
ülke, ad, dönem, kategori_kimlikleri, minimum gelir, maksimum gelir, minimum gelir artış oranı, maksimum gelir artış oranı, minimum satış artış oranı, maksimum satış artış oranı, satılan ürün sayısı, satılan ürün sayısı, en az satış sayısı, satılan_maksimum_sayısı, min_ortalama_birim_fiyatı, maksimum ortalama birim fiyat, min_komisyon_oranı, maksimum komisyon oranı, ürün_puanı_alt_sınırı, maksimum ürün puanı, min_ürün_yorum_sayısı, maksimum_ürün_yorum_sayısı, min_yaratıcı_sayısı, maksimum yaratıcı sayısı, ürün_piyasaya_çıkış_tarihi_min, ürün_lansman_tarihi_maks, min_yaratıcı_dönüşüm_oranı, maksimum_yaratıcı_dönüşüm_oranı, ilk kez görüldü, en düşük fiyat, maksimum fiyat |
Takma adlar: satılan ürün sayısı ← satılan en az; satılan ürün sayısı ← satılan maksimum.
İzin verilir sıralama değerler#
Sıralama anahtarları şunlardır: değil bu belgede ayrıntılı olarak açıklanmıştır; üst düzey analiz hizmeti, genel sıralama anahtarlarını belirli dönemlere ait alanlara eşler. Şu şekilde ele alın: sıralama web uygulamasının filtre arayüzüne hizalanmış opak bir dize olarak ya da aynı varlık için kontrol panelinden ağ isteklerini inceleyerek.
Yalnızca kontrol paneline özgü parametreler#
Ölçümleme için belgelenmemiş kontrol paneli sorgu bayraklarına güvenmeyin. API entegrasyonlarında yalnızca yukarıda belirtilen filtreleri gönderin ve " Krediler ve faturalandırma" bölümündeki talimatları izleyin.
GET /api/v1/tiktok-shop/products#
Sorgu parametreleri (auth hariç tümü isteğe bağlıdır):
| Parametre |
Varsayılan |
sayfa |
0 |
sınır |
20 |
sıralama |
satış_açıklaması |
kategori, en düşük fiyat, maksimum fiyat, min_satış, maksimum satış, en düşük puan, başlangıç tarihi, bitiş tarihi, arama, ülke |
— |
GET /api/v1/tiktok-shop/search (Ürünleri ara)#
| Parametre |
Zorunlu |
q |
Evet (arama dizesi) |
sayfa |
Hayır (0 (varsayılan) |
sınır |
Hayır (20 (varsayılan) |
kategori |
Hayır |
GETtrending (getTrendingProducts)#
| Parametre |
Varsayılan |
sınır |
10 |
zaman aralığı |
7 gün |
kategori |
— |
GET /api/v1/tiktok-shop/shop-details / mağazalar/ayrıntılar (Mağaza Bilgilerini Al)#
| Parametre |
Zorunlu |
id |
Evet — mağaza kodu |
GET /api/v1/tiktok-shop/öneriler (öneriler)#
| Parametre |
Zorunlu |
Notlar |
tür |
Evet |
Aşağıdakilerden biri: kategoriler, mağazalar, yaratıcılar, ürünler, videolar. |
q |
Evet |
Kısmi ad; boş bırakıldığında önerilerde hiçbir sonuç gösterilmez. |
sınır |
Hayır |
1–20, varsayılan 10. |
ülke |
Hayır |
Varsayılan ABD. |
Hiyerarşi ve statik okumalar#
| Yol |
Parametreler |
kategoriler/hiyerarşi, kategoriler/katmanlar |
ülke (varsayılan) ABD). |
kategoriler/özet, kategoriler/tarihçe, … |
Çoğunlukla AL sorgu parametreleri (ülke, kimlikler, süre, …); her bir rota için tam yapıya ilişkin ayrıntılar için uygulama içi ağ sekmesine bakın. |
İçin YAYIN detaylı güzergâhlardaki araçlar (ürün-detayı, ürün-detayı(vb.), her bir rotanın kendine özgü bir JSON yapısı vardır — kontrol panelinden ihtiyacınız olan sekme için bir istek yakalayın, ardından bunu /api/v1/tiktok-shop/... API anahtarınızla.
MCP araçları (Explore ile aynı veriler)#
Eğer kullanırsanız Model Bağlam Protokolü (Claude Desktop vb.), TikTok araçları şu komutu verir: aynı keşif/sayım yükleri HTTP API'si şunları kabul eder — aynı filtre mantığı uygun olduğu durumlarda bu belgeyi (anahtar kelime, ülke, sayfa, boyut vs HTTP sınır, ürünlere ilişkin gelir/fiyat sınırları, …).
| MCP aracı |
Haritalar |
tiktok_ürünlerini_ara |
ürünler/keşfet |
tiktok_shops_arama |
mağazalar/keşfet |
tiktok_yaratıcılarını_ara |
yaratıcılar/keşfet |
TikTok videolarını ara |
videolar/keşfet |
tiktok_varlıklarının_sayısı |
[...] dosyasında kullanılan filtrelerle eşleşen sonuçları sayar keşfet uç noktalar. |
TikTok kategorilerini göz at, tiktok_kategori_en_popüler, otomatik tamamlama_tiktok |
Kategori hiyerarşisi / katmanlar / özet / geçmiş / benzerler / en popülerler / öneriler |
get_tiktok_product, get_tiktok_shop, get_tiktok_creator, get_tiktok_video |
Ayrıntı + dilim yükleri (metrikler, geçmiş, listeler, strateji) — bkz. MCP araçları kılavuzu |
get_tiktok_trending_products |
Aynı fikir GETtrending (aşağıdaki bölüm) |
kredileri kontrol et |
Aynı fikir GET /api/v1/tiktok-shop/credits |
Tam argüman adları: MCP · araçlar kılavuzu.
Şimdi nereye bakmalı?#
| Endişe |
Konum |
| Yol listesi (yollar + fiiller) |
API kılavuzu — TikTok Shop bölümü |
| Filtreler ve gövdeler (bu belge) |
Yukarıdaki tablolar |
| Varlık ayrıntıları (JSON gövdeleri) |
TikTok Shop hakkında ayrıntılar |
| ce](/docs/api) — TikTok Shop bölümü |
|
| Filtreler ve gövdeler (bu belge) |
Yukarıdaki tablolar + istisnai durumlar için uygulama içi ağ yakalamaları |
