TikTok Shop API – Filter und Abfrageparameter
Diese Referenz richtet sich an Integratoren, die /api/v1/tiktok-shop/* mit einem API-Schlüsseloder die gleichen Pfadformen unter /api/tiktok-shop/... im angemeldeten Zustand Browsersitzung. Liste der HTTP-Routen und allgemeines Verhalten: API-Referenz.
Wie Parameter übermittelt werden#
| Mechanismus |
Details |
| Abfragezeichenfolge |
Wie bei GET üblich. |
| JSON senden |
Bei Explore- und Count-Routen, die POST-Anfragen akzeptieren, wird ein JSON-Objekt im Request-Body mit den Abfrageparametern zusammengeführt (gleiche Schlüssel wie in den folgenden Tabellen). Verwenden Sie diese Methode, wenn die Filtersätze umfangreich sind (vermeidet den Fehler „414 URI Too Long“). |
| POST-Formular |
application/x-www-form-urlencoded Der Textkörper wird ebenfalls in „params“ eingefügt. |
| Ausgelassen / leer |
Leere Zeichenkette, nulloder die Literalzeichenfolge „undefiniert“ werden entfernt und meist ignoriert. |
Entdecken & zählen (Kategorien, Shops, Kreative, Videos, Produkte)#
Diese entsprechen:
Routensuffix (unter /api/v1/tiktok-shop/) |
Zweck |
Kategorien/Entdecken, Kategorien/Anzahl |
Kategorien auflisten oder filtern / Treffer zählen |
Shops/Entdecken, Geschäfte/Anzahl |
Geschäfte auflisten oder suchen / Treffer zählen |
Schöpfer/Entdecken, Anzahl der Urheber |
Ersteller auflisten oder suchen / Treffer zählen |
Videos/Entdecken, Anzahl der Videos |
Videos auflisten oder suchen / Treffer zählen |
Produkte/Entdecken, Anzahl der Produkte |
Produkte auflisten oder suchen / Treffer zählen |
Paginierung und Sortierung (nur zur Ansicht; wird bei der Zählung nicht berücksichtigt)
| Parameter |
Standard |
Anmerkungen |
Seite |
1 |
Ganzzahlseite. |
Grenze |
20 |
Seitengröße. |
danach |
— |
Undurchsichtiger Cursor für den Tastensatz (Vorwärtsblättern). |
Gesamtbetrag |
— |
Falls vorhanden, an den Upstream-Anbieter weitergeleitet. |
Checkpoint-Sprung |
— |
Falls vorhanden, an den Upstream-Anbieter weitergeleitet. |
sortieren |
Siehe „default_sort“ pro Entität weiter unten |
Upstream ordnet periodenspezifische Sortierfelder zu. |
Bestellung |
Beschreibung |
Sortierrichtung. |
Kategorienabgrenzung (Erkunden & Zählen, wenn hat_Kategoriehierarchie (ist wahr)#
| Parameter |
Anmerkungen |
Kategorie-IDs |
Durch Kommas getrennt oder als Array; wird mit den nachstehenden Ebenen-IDs zusammengeführt. |
category_l1_id, category_l2_id, category_l3_id |
Eine ID; mehrere Aliase category_l1_ids, category_l2_ids, category_l3_ids wird ebenfalls akzeptiert. |
exclude_category_ids |
Durch Kommas getrennte Liste der auszuschließenden Elemente. |
| Parameter |
Standard |
Land |
USA |
Entitätsspezifische Filter#
Jede Entität stellt eine Reihe von Filtern zur Verfügung, die auf der Zulassungsliste stehen. Anfragen verwenden kanonische Parameternamen; Aliase akzeptieren alternative Namen (mit demselben Wert).
Kategorien — default_sort: Umsatzquelle#
| Filter |
Land, Ebene, Kategorie-IDs, Name, Zeitraum, Mindestumsatz, max_revenue, Mindestumsatz pro Geschäft, max_umsatz_pro_Geschäft, min_top_3_shop_ratio, max_top_3_shop_ratio, min_Top-10-Shop-Quote, Anteil der Top-10-Shops, min_shop_count, max_shop_count, min_video_count, max_video_count |
Aliasnamen: Mindestumsatz ← min_umsatz_30_Tage; max_revenue ← max_revenue_30_days.
Geschäfte — default_sort: Umsatz#
| Filter |
Land, Name, Zeitraum, Kategorie-IDs, Mindestumsatz, max_revenue, min_Umsatzwachstumsrate, maximale Umsatzwachstumsrate, min_Umsatzwachstumsrate, maximale Umsatzwachstumsrate, erstmals gesehen, Mindestbewertung, max_rating, Verkäufertyp, min_product_count, max_product_count, min_durchschnittlicher_Stückpreis, max_avg_unit_price, min_creator_count, max_creator_count, min_video_count, max_video_count, min_channel_strategy_selbstverwalteter_Anteil, max_channel_strategy_selbstverwalteter_Anteil |
Aliasnamen: Mindestumsatz ← min_gmv_30d; max_revenue ← max_gmv_30d; min_Umsatzwachstumsrate ← min_gmv_wachstumsrate_30tage; maximale Umsatzwachstumsrate ← max_gmv_wachstumsrate_30tage; min_durchschnittlicher_Stückpreis ← min_avg_price; max_avg_unit_price ← Durchschnittspreis.
Urheber — default_sort: Umsatz#
| Filter |
Land, Name, Zeitraum, Kategorie-IDs, Mindestumsatz, max_revenue, min_Umsatzwachstumsrate, maximale Umsatzwachstumsrate, min_Follower-Wachstumsrate, maximale Wachstumsrate der Follower, min_views_growth_rate, max_views_growth_rate, min_followers, max_followers, min_views, max_views, verifiziert, min_product_count, max_product_count, min_video_count, max_video_count |
Aliasnamen: Mindestumsatz ← min_gmv_30d; max_revenue ← max_gmv_30d.
Videos — default_sort: Umsatz#
| Filter |
Land, Name, Zeitraum, Kategorie-IDs, Mindestumsatz, max_revenue, min_Umsatzwachstumsrate, maximale Umsatzwachstumsrate, min_views_growth_rate, max_views_growth_rate, min_likes_wachstumsrate, maximale Wachstumsrate der Likes, Mindestwachstumsrate der Aktien, maximale Wachstumsrate der Aktien, min_views, max_views, min_duration, max_duration, min_roas, max_roas, Mindestausgaben für Werbung, maximale Werbeausgaben, min_likes, max_likes, min_creator_followers, max_creator_followers, Veröffentlichungsdatum, ist_Anzeige, ist_Partner, ist_Selbstdarstellung, ist_ai_ugc, Umsatzentwicklung |
Produkte — default_sort: Umsatz#
| Filter |
Land, Name, Zeitraum, Kategorie-IDs, Mindestumsatz, max_revenue, min_Umsatzwachstumsrate, maximale Umsatzwachstumsrate, min_Umsatzwachstumsrate, maximale Umsatzwachstumsrate, Mindestverkaufszahl, max_verkaufte_Artikel, Mindestverkaufszahl, max_verkaufte_Stückzahl, min_durchschnittlicher_Stückpreis, max_avg_unit_price, Mindestprovisionssatz, max_commission_rate, min_product_score, max_product_score, min_product_review_cnt, max_product_review_cnt, min_creator_count, max_creator_count, min_product_launch_date, max_product_launch_date, min_creator_conversion_ratio, max_creator_conversion_ratio, erstmals gesehen, Mindestpreis, Höchstpreis |
Aliasnamen: Mindestverkaufszahl ← Mindestverkaufszahl; max_verkaufte_Artikel ← max_verkauft.
Zulässig sortieren Werte#
Sortierschlüssel sind nicht in diesem Dokument vollständig aufgeführt; der vorgelagerte Analysedienst ordnet generische Sortierschlüssel periodenspezifischen Feldern zu. Behandeln Sie sortieren entweder als undurchsichtige Zeichenfolge, die an die Filteroberfläche der Web-App angepasst ist, oder indem Sie die Netzwerkaufrufe für dieselbe Entität im Dashboard überprüfen.
Parameter, die nur im Dashboard verfügbar sind#
Verlassen Sie sich bei der Abrechnung nicht auf nicht dokumentierte Abfrageflags im Dashboard. Senden Sie bei API-Integrationen nur die oben dokumentierten Filter und beachten Sie die Hinweise unter „Guthaben und Abrechnung“.
GET /api/v1/tiktok-shop/products#
Abfrageparameter (alle optional, außer „auth“):
| Parameter |
Standard |
Seite |
0 |
Grenze |
20 |
sortieren |
sales_desc |
Kategorie, Mindestpreis, Höchstpreis, Mindestumsatz, max_sales, Mindestbewertung, Beginn, bis, Suche, Land |
— |
GET /api/v1/tiktok-shop/search (Produkte suchen)#
| Parameter |
Erforderlich |
q |
Ja (Suchbegriff) |
Seite |
Nein (0 (Standard) |
Grenze |
Nein (20 (Standard) |
Kategorie |
Nein |
GETtrending (getTrendingProducts)#
| Parameter |
Standard |
Grenze |
10 |
Zeitrahmen |
7 Tage |
Kategorie |
— |
GET /api/v1/tiktok-shop/shop-details / Geschäfte/Details (Shop-Details abrufen)#
| Parameter |
Erforderlich |
id |
Ja – Shop-ID |
GET /api/v1/tiktok-shop/suggestions (Vorschläge)#
| Parameter |
Erforderlich |
Anmerkungen |
Typ |
Ja |
Entweder: Kategorien, Geschäfte, Urheber, Produkte, Videos. |
q |
Ja |
Teilname; bei leerem Feld werden keine Vorschläge angezeigt. |
Grenze |
Nein |
1–20, Standard 10. |
Land |
Nein |
Standard USA. |
| Pfad |
Parameter |
Kategorien/Hierarchie, Kategorien/Ebenen |
Land (Standard USA). |
Kategorien/Zusammenfassung, Kategorien/Geschichte, … |
Meistens HOLEN Abfrageparameter (Land, IDs, Zeitraum, …); die genaue Struktur pro Route finden Sie auf der Registerkarte „Netzwerk“ in der App. |
Für BEITRAG Fahrzeuge auf Nebenstrecken (Produktdetails, Produktdetailsusw.), hat jede Route ihre eigene JSON-Struktur – erfassen Sie eine Anfrage aus dem Dashboard für die gewünschte Registerkarte und spielen Sie diese dann ab /api/v1/tiktok-shop/... mit Ihrem API-Schlüssel.
MCP-Tools (gleiche Daten wie bei „Explore“)#
Wenn Sie Modellkontextprotokoll (Claude Desktop usw.), geben die TikTok-Tools die gleiche Explore-/Count-Payloads Die HTTP-API akzeptiert — gleiche Filtersemantik soweit zutreffend, wie in diesem Dokument beschrieben (Stichwort, Land, Seite, Größe vs. HTTP Grenze, Umsatz-/Preisgrenzen für Produkte, …).
| MCP-Tool |
Karten zu |
TikTok-Produkte suchen |
Produkte/Entdecken |
TikTok-Shops suchen |
Shops/Entdecken |
TikTok-Creators suchen |
Schöpfer/Entdecken |
TikTok-Videos suchen |
Videos/Entdecken |
Anzahl der TikTok-Entitäten |
Zählt die Ergebnisse, die denselben Filtern entsprechen, die in der entdecken Endpunkte. |
TikTok-Kategorien durchsuchen, Liste der beliebtesten TikTok-Kategorien, autocomplete_tiktok |
Kategorienhierarchie / Ebenen / Übersicht / Verlauf / Gleichrangige / Top-Listen / Vorschläge |
get_tiktok_product, get_tiktok_shop, get_tiktok_creator, get_tiktok_video |
Detail- und Slice-Nutzdaten (Metriken, Verlauf, Listen, Strategie) – siehe MCP-Tool-Referenz |
get_tiktok_trending_products |
Das gleiche Prinzip wie GETtrending (Abschnitt unten) |
Abspann |
Das gleiche Prinzip wie GET /api/v1/tiktok-shop/credits |
Vollständige Argumentnamen: MCP · Tools-Referenz.
| Sorge |
Standort |
| Routenliste (Wege + Verben) |
API-Referenz – Abschnitt „TikTok Shop“ |
| Filter und Gehäuse (dieses Dokument) |
Die obigen Tabellen |
| Entitätsdetails (JSON-Inhalte) |
Details zum TikTok Shop |
| ce](/docs/api) – Bereich „TikTok Shop“ |
|
| Filter und Gehäuse (dieses Dokument) |
Die obigen Tabellen + Netzwerk-Snapshots aus der App für Sonderfälle |
