Documentos
Ctrl+K Buscar Alt+[Alt+] Guías
Obtener clave API

Guías

Intervalos de tiempo

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

De un

Superficie Parámetro Valores típicos
TikTok Shop: explorar / recuento / detalles período 7d, 30d, 90d, a veces todos
Rastreador de marcas (/api/v1/brands/* and session /api/marcas/...) fecha_rango + opcional fecha_de_inicio, fecha_hasta en directo, 7d, 30d, 3m, 6m, personalizado
Puntos finales de eventos de visitas a TikTok Shop período 7d, 30d, todos (por defecto 30d)
GET /api/v1/tiktok-shop/products fecha_de_inicio, fecha_hasta A-M-D
Biblioteca de anuncios (/api/v1/adlibrary) Dashboard-compatible query params See Meta ad library
Google Ads fecha_de_inicio / fecha_hasta, first_seen_* See Google Ads

Most common mistake: sending fecha_de_inicio / fecha de finalización con período on TikTok Shop. Pass solo período unless a specific endpoint documents otherwise.

TikTok Shop período

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"
  • Dale un capricho período as an opaque string mirroring the in-app UI.
  • Sort keys follow the same period (ordenar=ingresos + periodo=7 días → ingresos_7d upstream).

Visit-event endpoints

producto-otras-visitas, categoría-visita-eventos, detalles-visita-eventos:

período= Ventana
(omitido) El valor predeterminado es 30d
7d, 30d Ventana móvil de N días
todos / de todos los tiempos Totales acumulados
<integer> (p. ej., 90) Considerado como Nd

Responses include etiqueta de período for display.

Rastreador de marcas fecha_rango

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

date_range= Efecto
(omitido) o todos No date filter
en directo Last seen in the last 4 days (actualizado el)
7d, 30d, 3m, 6m Start date on or after rolling cutoff
personalizado Requiere ambos fecha_de_inicio y fecha_hasta como A-M-D

Flat products listing

GET /api/v1/tiktok-shop/products accepts fecha_de_inicio / fecha_hasta (A-M-D). Prefer período on every other TikTok Shop path.

Decision tree

  1. Explore / count / detail / history under /api/v1/tiktok-shop/ → período
  2. Flat GET .../products → fecha_de_inicio / fecha_hasta
  3. Visit-event routes → período=7 días|30 días|todos
  4. Session or v1 /api/marcas/* insight tabs → fecha_rango (+ 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.