Docs
Ctrl+K Rechercher Alt+[Alt+] Guides
Obtenir une clé API

Guides

Plages horaires

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

En bref

Surface Paramètre Valeurs typiques
TikTok Shop: découvrir / nombre / détails période 7d, 30d, 90d, parfois tout
Suivi des marques (/api/v1/brands/* and session /api/brands/...) date_range + facultatif date_de_début, date_to en direct, 7d, 30d, 3m, 6m, personnalisé
Points de terminaison des événements liés aux visites sur TikTok Shop période 7d, 30d, tout (par défaut 30d)
GET /api/v1/tiktok-shop/products date_de_début, date_to J-m-a
Bibliothèque de publicités (/api/v1/adlibrary) Dashboard-compatible query params See Meta ad library
Google Ads date_de_début / date_to, first_seen_* See Google Ads

Most common mistake: sending date_de_début / date_de_fin avec période on TikTok Shop. Pass seulement période unless a specific endpoint documents otherwise.

TikTok Shop période

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"
  • Gâter période as an opaque string mirroring the in-app UI.
  • Sort keys follow the same period (tri=chiffre d'affaires + durée = 7 jours → chiffre d'affaires_7j upstream).

Visit-event endpoints

produit-autres-visites, catégorie-visite-événements, détails-visite-événements:

période= Fenêtre
(omission) Par défaut, 30d
7d, 30d Fenêtre glissante de N jours
tout / de tous les temps Totaux cumulés
<integer> (par exemple 90) Considéré comme Nd

Responses include étiquette_période for display.

Suivi des marques date_range

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

date_range= Effet
(omission) ou tout No date filter
en direct Last seen in the last 4 days (dernière mise à jour)
7d, 30d, 3m, 6m Start date on or after rolling cutoff
personnalisé Nécessite les deux date_de_début et date_to comme J-m-a

Flat products listing

GET /api/v1/tiktok-shop/products accepts date_de_début / date_to (J-m-a). Prefer période on every other TikTok Shop path.

Decision tree

  1. Explore / count / detail / history under /api/v1/tiktok-shop/ → période
  2. Flat GET .../products → date_de_début / date_to
  3. Visit-event routes → période=7j|30j|tout
  4. Session or v1 /api/brands/* insight tabs → date_range (+ 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.