Belgeler
Ctrl+K Arama Alt+[Alt+] Kılavuzlar
API anahtarını al

Kılavuzlar

Zaman aralıkları

Different surfaces use different date filters. Pick one mechanism per request — don’t mix them.

Bir bakışta

Yüzey Parametre Tipik değerler
TikTok Shop keşfet / say / ayrıntılar dönem 7d, 30d, 90d, bazen hepsi
Marka takipçisi (/api/v1/brands/* and session /api/markalar/...) tarih aralığı + isteğe bağlı başlangıç tarihi, bitiş tarihi canlı, 7d, 30d, 3m, 6m, özel
TikTok Shop ziyaret etkinliği uç noktaları dönem 7d, 30d, hepsi (varsayılan) 30d)
GET /api/v1/tiktok-shop/products başlangıç tarihi, bitiş tarihi A-G-Y
Reklam kütüphanesi (/api/v1/adlibrary) Dashboard-compatible query params See Meta ad library
Google Ads başlangıç tarihi / bitiş tarihi, first_seen_* See Google Ads

Most common mistake: sending başlangıç_tarihi / bitiş tarihi ile dönem on TikTok Shop. Pass sadece dönem unless a specific endpoint documents otherwise.

TikTok Mağazası dönem

Used by explore, count, detail aggregates, history, and most metric endpoints under /api/v1/tiktok-shop/.

curl -sS \
  -H "X-API-Key: $WH_API_KEY" \
  "{origin}/api/v1/tiktok-shop/products/explore?country=US&period=30d&limit=20"
  • Tedavi dönem as an opaque string mirroring the in-app UI.
  • Sort keys follow the same period (sıralama=gelir + süre=7 gün → 7 günlük gelir upstream).

Visit-event endpoints

ürün-diğer-ziyaretler, kategori-ziyaret-etkinlikler, etkinliklere-ayrıntılı-ziyaret:

dönem= Pencere
(çıkarılmıştır) Varsayılan olarak 30d
7d, 30d N günlük kayan aralık
hepsi / tüm zamanların Toplam rakamlar
<integer> (örneğin 90) Şu şekilde değerlendirilir Nd

Responses include dönem etiketi for display.

Marka takipçisi tarih aralığı

Works on /api/v1/brands/* insight/ads tabs and session /api/markalar/....

date_range= Etki
(çıkarılmıştır) ya da hepsi No date filter
canlı Last seen in the last 4 days (güncelleme tarihi)
7d, 30d, 3m, 6m Start date on or after rolling cutoff
özel Her ikisi de gereklidir başlangıç tarihi ve bitiş tarihi gibi A-G-Y

Flat products listing

GET /api/v1/tiktok-shop/products accepts başlangıç tarihi / bitiş tarihi (A-G-Y). Prefer dönem on every other TikTok Shop path.

Decision tree

  1. Explore / count / detail / history under /api/v1/tiktok-shop/ → dönem
  2. Flat GET .../products → başlangıç tarihi / bitiş tarihi
  3. Visit-event routes → dönem=7 gün|30 gün|tümü
  4. Session or v1 /api/markalar/* insight tabs → tarih aralığı (+ custom dates if needed)
  5. Meta ads → Meta ad library
  6. Google Ads → Google Ads

Related

TikTok Shop FiltersExplore / count params including period. BrandsAPI key routes for list, ads, and insight tabs. TroubleshootingEmpty results from mixed date params.