Übergeben Sie TikTok-Shop-Produkt-IDs oder SPUs und erhalten Sie Titel, Preis, Verkäufer, Versand, SKU und Erfassungsstatus
TikTok Shop Keyword Search
Give one TikTok Shop search keyword and an expected product count to get matching US listings with shop, price, and sales signals.
Original · en-USZur Übersetzung
Übersicht
Searching TikTok Shop by keyword is how shoppers actually discover products, but the public listing is hard to capture as a comparable dataset: titles, prices, shops, and rank shift together, and screenshots do not survive analysis. This app turns one search keyword into a structured list of matching United States TikTok Shop products so merchandising, brand, and research teams can see what currently appears for that term.
Unlike opening a product page you already know, keyword search shows which listings occupy the shelf for a brand, category, or campaign phrase. Keeping product identity, listing commercial signals, and shop context in the same row makes it possible to compare terms, watch a brand's presence, or build a candidate set without copying results by hand.
Data notes
Each record is a public product listing associated with the submitted search keyword on TikTok Shop in the United States. Product IDs are de-duplicated within the returned dataset. Matched keyword, Business ID, and Source item preserve the search context and may repeat across many products from the same task. Listings are returned in a stable ascending collection-time order.
Price is the listing amount as a raw string, with no separate currency field. Collect timestamp and Created timestamp are millisecond strings; Collection time has no timezone, so it should not be treated as an absolute cross-region clock. Search rank starts at 0. A No-data marker distinguishes a search item that produced no matching products from ordinary listing rows.
The collection covers public United States search listings only. It does not include other country catalogs, product-detail specifications, comments, or order data.
What a result looks like
Each row is one TikTok Shop product listing associated with the search keyword, or a no-data marker for that search.
| Product title | Product ID | Price | Shop name | Sales count | Search rank |
|---|---|---|---|---|---|
| Micro Ingredients Whole Milk Powder, 4lbs, Made in USA | 1729435358486827693 | 41.54 | Micro Ingredients | 23284 | 0 |
| Binggrae Flavored Milk Drink, Banana Flavor 200ml * 6 Cartons | 1729408858647663361 | 18.26 | Weee Asian Supermarket | 6714 | 1 |
Brand name, Product image, Rating count, Shop ID, Collection time, and No-data marker are also available when supplied with the record.
Use cases
- For keyword merchandising, group rows by Matched keyword and compare Product title, Price, and Shop name to see which listings occupy the search shelf.
- For competitive tracking, sort by Search rank and use Sales count with Rating count to separate highly visible listings from long-tail products.
- For brand monitoring, compare Brand name against Shop name and Product ID to see whether branded goods are sold by the brand shop or by other merchants.
- For sourcing follow-up, keep Product ID, Shop ID, and Product image together so the same listing can be reopened later without repeating the search by hand.
Anwendungsbereich & Grenzen
One TikTok Shop search keyword per task with an expected result count from 1 to 300; results are returned in complete batches of 30 and may be rounded up; coverage is limited to public US TikTok Shop search listings.
- Geeignet für
- When you need US TikTok Shop products that appear for a brand, product, or category keyword.
- When you need a structured list that connects each matched listing with its shop, price, rank, and public sales or rating signals.
- Nicht verwenden für
- When you need full product specifications, comments, or order data from a product detail page.
- When you need an immediate single-record lookup rather than a background keyword collection task.
- When you need TikTok Shop listings from regions other than the United States.
Fehlerbehandlung
Vom Entwickler deklariertes Fehler- und Wiederholungsverhalten. Wir empfehlen, es bei der Integration in Ihren System-Prompt aufzunehmen.
- 1If no matching records are returned, try a shorter or broader search phrase and resubmit.
- 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
- 3Retry later after rate limiting, temporary service unavailability, or a timeout.
- 4If authentication fails, verify the API Key configured for the execution environment.
Eingabe
Parameter, die zum Aufruf dieser App erforderlich sind, generiert aus dem input.schema in der manifest.json.
- Search keyword
keywordErforderlichstringA brand, product, or category phrase to search on TikTok Shop. Each task accepts one keyword from 1 to 512 characters.Beispielmilk - Expected result count
crawl_countErforderlichintegerExpected number of product listings, from 1 to 300. Results are returned in complete batches of 30, so the actual count may be rounded up. Incomplete batches are still billed as 30 records.Bereich1–300Beispiel30
Ausgabe
Feldstruktur eines einzelnen Datensatzes, generiert aus dem output.schema in der manifest.json.
- Business ID
biz_idstringBusiness grouping identifier returned with the collected listing; empty when none is returned.Beispielmilk - Brand name
brand_namestringBrand name shown on the product listing; empty when none is returned.BeispielMicro Ingredients - Collect timestamp
collect_timestringCollect time as a millisecond timestamp string; empty when none is returned.Beispiel1789121807761 - Collection time
crawl_timestringCollection time for the listing; the source does not specify a timezone.Beispiel2026-09-11T18:16:47
Beispieldaten
Aus output.schema erzeugt. Felder ohne Beispielwert verwenden strukturelle Platzhalter.
{
"biz_id": "milk",
"brand_name": "Micro Ingredients",
"collect_time": "1789121807761",
"crawl_time": "2026-09-11T18:16:47",
"created_at": "1789121807761",
"image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a6be9c262efc4e9e95cce5c93daa4ccf~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
"keyword": "milk",
"page_num": "1",
"platform_code": "tiktokShop",
"price": "41.54",
"product_id": "1729435358486827693",
"product_title": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA",
"rank_index": 0,
"rating_count": "3185",
"sale_count": "23284",
"shop_id": "7494949083499694765",
"shop_name": "Micro Ingredients",
"status_code": "<status_code>",
"source_item": "milk",
"no_data": false
}Integration
Diese App kann über MCP, API, SDK oder Dateiexport integriert werden — alle Kanäle teilen sich dieselben Fähigkeiten und Preise. Jede Anfrage authentifiziert sich über den Authorization: Bearer-Header mit einem API Key (langlebig, in der Data Hub Konsole erstellt); MCP-Clients können sich zusätzlich per OAuth ohne Key anmelden. Weitere Optionen wie CLI und Skill sind in Vorbereitung. Diese App läuft asynchron und kann zwischendurch abgebrochen werden: Nach dem Abbruch stoppt der Lauf. Bereits gelieferte Datensätze bleiben erhalten und werden abgerechnet.
Über das MCP (Model Context Protocol) können Sie diese App direkt aus KI-Clients wie Claude und Cursor aufrufen. Wählen Sie Ihren Client und den Authentifizierungsmodus und kopieren Sie dann die Konfiguration unten.
Client-Konfiguration
Ersetzen Sie den Wert nach Bearer durch Ihren langlebigen API Key. Funktioniert in jedem Client, in CI und in Headless-Umgebungen.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/tiktok-shop-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Lassen Sie die KI die Einrichtung übernehmen
Sie möchten Konfigurationen nicht von Hand bearbeiten? Kopieren Sie den Installations-Prompt und fügen Sie ihn in einen beliebigen KI-Client ein — er schließt die Einrichtung auf seine eigene Weise ab. (Standardmäßig führt er Sie durch die Anmeldung und fordert Sie nie auf, Ihren API Key im Chat zu senden.)
detail.access.mcp.composeHint
Preise
Berechnet nach der Anzahl der erfolgreich zurückgegebenen Datensätze. Fehlgeschlagene Läufe werden nicht berechnet. Abgerechnet in Einheiten von 30 Datensätze; jede angefangene Einheit wird auf 30 Datensätze aufgerundet.
Wird pro übermitteltem Lauf einmal berechnet, unabhängig davon, wie viele Datensätze zurückgegeben werden.
Mehrere Abrechnungsereignisse werden unabhängig voneinander kumuliert. Details siehe jeweilige Position. Fehlgeschlagene Läufe werden nicht berechnet.
Credits ansehenJetzt ausprobieren
Füllen Sie die Parameter aus und starten Sie — die Ergebnisse stammen aus einem echten Aufruf.