FR

TikTok Keyword Search

Give one TikTok search keyword and an expected count to get matching public video identifiers, links, and collection metadata.

Source · en-USRevenir à la traduction

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

Aperçu

Researching how a topic appears in TikTok search often starts with a dependable set of matching video identifiers and public links. This app turns one search keyword into a structured collection of matching items, keeping the keyword and collection context beside each identifier so the dataset remains understandable after it is exported or joined with other research material.

The result is useful as a discovery index: it shows which public videos were associated with a brand, product, topic, or campaign at collection time. It is especially suited to building repeatable monitoring sets, comparing the content populations found for different terms, and preparing identifiers and links for later analysis without manually copying items from search pages.

Data notes

Each record represents one TikTok item associated with the submitted search keyword. Content IDs are de-duplicated within the returned dataset. Matched keyword, Source item, and Business ID preserve the collection context and may repeat across many records from the same search. Collection time is returned without timezone information, so it should not be treated as an absolute cross-region timestamp without additional context. Keyword type describes the kind of search item attached to the record.

The collection contains identifiers, public video links, and collection metadata, not captions, transcripts, engagement totals, comments, or a complete creator profile. A No-data marker distinguishes search metadata that reports no matching content from ordinary matched records. Private, deleted, or otherwise non-searchable TikTok content is not covered.

What a result looks like

Each row is one matched TikTok video or a no-data marker associated with the search keyword.

Content IDMatched keywordContent URLCollection timeNo-data marker
7678592532162284813bluetooth earbudshttps://www.tiktok.com/@rebeccashao0/video/76785925321622848132026-08-27T15:13:22No
7678160781283822879bluetooth earbudshttps://www.tiktok.com/@stitch.series6/video/76781607812838228792026-08-27T15:13:22No

Keyword type, Collection record ID, Business ID, and Source item are also available when supplied with the record.

Use cases

  • For topic discovery, group rows by Matched keyword and count distinct Content ID values to compare the searchable video population associated with each term.
  • For monitoring, repeat a keyword collection and compare Content ID sets while using Collection time as source-provided context for newly observed items.
  • For provenance checks, compare Matched keyword, Source item, and Business ID to confirm which search context produced each video before combining datasets.
  • For follow-up review, open Content URL values and filter on No-data marker to separate empty-search metadata from usable matched records.

Périmètre et limites

One TikTok search keyword per task with an expected result count from 1 to 200; results are returned in complete batches of 10 and may be rounded up; coverage is limited to public TikTok keyword search listings.

  • Adapté pour
  • When you need content identifiers and public video links returned by a TikTok keyword search for a brand, product, topic, or campaign.
  • When you need a structured list that connects each matched video with its search keyword and collection metadata.
  • À ne pas utiliser pour
  • When you need captions, transcripts, engagement metrics, comments, or complete creator profiles.
  • When you need an immediate single-record lookup rather than a background keyword collection task.

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, verify the keyword or try a shorter and broader search phrase.
  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, topic, or phrase to search on TikTok. Each task accepts one keyword from 1 to 512 characters.
    ExempleShokz
  • Expected result countcrawl_countRequisinteger
    Expected number of search results, from 1 to 200. Results are returned in complete batches of 10, so the actual count may be rounded up.
    Plage1–200Exemple1

Sortie

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

  • Content IDcontent_idstring
    Unique identifier of the matched TikTok video.
    Exemple7678592532162284813
  • Content URLcontent_urlstring
    Public TikTok video URL for the matched item.
    Exemplehttps://www.tiktok.com/@rebeccashao0/video/7678592532162284813
  • Matched keywordkeywordstring
    Search keyword associated with the collected content item.
    Exemplebluetooth earbuds
  • Keyword typekeyword_typestring
    Classification of the search item associated with the record.
    Exemplekeyword

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
{
  "content_id": "7678592532162284813",
  "content_url": "https://www.tiktok.com/@rebeccashao0/video/7678592532162284813",
  "keyword": "bluetooth earbuds",
  "keyword_type": "keyword",
  "crawl_time": "2026-08-27T15:13:22",
  "cur_id": "6a8fe396b799f44efa7f2ff0",
  "biz_id": "bluetooth earbuds",
  "source_item": "bluetooth earbuds",
  "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=hello_moto/tiktok-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

10 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 10 enregistrements ; toute unité incomplète est arrondie à 10 enregistrements.

0,002 $US/ 10 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,002 $US / 10 enregistrements