FR

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.

Source · en-USRevenir à la traduction

Développeur
Tarifs
À partir de 0,005 $US / 30 enregistrements
Dernière mise à jour
2026-09-18

Aperçu

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 titleProduct IDPriceShop nameSales countSearch rank
Micro Ingredients Whole Milk Powder, 4lbs, Made in USA172943535848682769341.54Micro Ingredients232840
Binggrae Flavored Milk Drink, Banana Flavor 200ml * 6 Cartons172940885864766336118.26Weee Asian Supermarket67141

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.

Périmètre et limites

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.

  • Adapté pour
  • 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.
  • À ne pas utiliser pour
  • 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.

Gestion des échecs

Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.

  1. 1If no matching records are returned, try a shorter or broader search phrase and resubmit.
  2. 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
  3. 3Retry later after rate limiting, temporary service unavailability, or a timeout.
  4. 4If authentication fails, verify the API Key configured for the execution environment.

Entrée

Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.

  • Search keywordkeywordRequisstring
    A brand, product, or category phrase to search on TikTok Shop. Each task accepts one keyword from 1 to 512 characters.
    Exemplemilk
  • Expected result countcrawl_countRequisinteger
    Expected 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.
    Plage1–300Exemple30

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

  • Business IDbiz_idstring
    Business grouping identifier returned with the collected listing; empty when none is returned.
    Exemplemilk
  • Brand namebrand_namestring
    Brand name shown on the product listing; empty when none is returned.
    ExempleMicro Ingredients
  • Collect timestampcollect_timestring
    Collect time as a millisecond timestamp string; empty when none is returned.
    Exemple1789121807761
  • Collection timecrawl_timestring
    Collection time for the listing; the source does not specify a timezone.
    Exemple2026-09-11T18:16:47

Exemple de données

Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.

output.example
{
  "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
}

Intégration

Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.

Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.

Config du client

Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/tiktok-shop-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Laissez l'IA tout configurer pour vous

Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Par défaut, il vous guide pour vous connecter et ne vous demande jamais d'envoyer votre API Key dans la conversation.)

detail.access.mcp.composeHint

Tarifs

30 returned records

Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 30 enregistrements ; toute unité incomplète est arrondie à 30 enregistrements.

0,005 $US/ 30 enregistrements
Per task submitted

Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.

0,0001 $US/ exécution

Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.

Voir les crédits

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple
Les paramètres sont validés par rapport à l'input.schema avant la soumission
À partir de 0,005 $US / 30 enregistrements