Dokumente
Strg+K Suchen Alt+[Alt+] Hilfslinien
API-Schlüssel abrufen

Anleitungen

Zeitfenster

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

Auf einen

Oberfläche Parameter Typische Werte
TikTok Shop: Entdecken / Anzahl / Details Zeitraum 7d, 30d, 90d, manchmal alle
Marken-Tracker (/api/v1/brands/* and session /api/brands/...) Datum + optional Beginn, bis live, 7d, 30d, 3m, 6m, benutzerdefiniert
Endpunkte für Besuchs-Events im TikTok Shop Zeitraum 7d, 30d, alle (Standard 30d)
GET /api/v1/tiktok-shop/products Beginn, bis J-M-T
Anzeigenbibliothek (/api/v1/adlibrary) Dashboard-compatible query params See Meta ad library
Google Ads Beginn / bis, first_seen_* See Google Ads

Most common mistake: sending Startdatum / Enddatum mit Zeitraum on TikTok Shop. Pass nur Zeitraum unless a specific endpoint documents otherwise.

TikTok Shop Zeitraum

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"
  • Leckerli Zeitraum as an opaque string mirroring the in-app UI.
  • Sort keys follow the same period (sort=Umsatz + Zeitraum=7 Tage → Umsatz_7d upstream).

Visit-event endpoints

Produkt – Sonstiges – Besuche, Kategorie: Veranstaltungen besuchen, Veranstaltungen im Detail:

Zeitraum= Fenster
(ausgelassen) Standardmäßig 30d
7d, 30d Gleitendes N-Tage-Fenster
alle / aller Zeiten Gesamtzahlen
<integer> (z. B. 90) Behandelt als Nd

Responses include Zeitraumbezeichnung for display.

Marken-Tracker Datum

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

date_range= Wirkung
(ausgelassen) oder alle Kein Datumsfilter
live Last seen in the last 4 days (aktualisiert am)
7d, 30d, 3m, 6m Start date on or after rolling cutoff
benutzerdefiniert Beides erforderlich Beginn und bis als J-M-T

Flat products listing

GET /api/v1/tiktok-shop/products accepts Beginn / bis (J-M-T). Prefer Zeitraum on every other TikTok Shop path.

Decision tree

  1. Explore / count / detail / history under /api/v1/tiktok-shop/ → Zeitraum
  2. Flat GET .../products → Beginn / bis
  3. Visit-event routes → Zeitraum=7 Tage|30 Tage|alle
  4. Session or v1 /api/brands/* insight tabs → Datum (+ 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.