FR

Recherche TikTok par mot-clé

Indiquez un mot-clé de recherche TikTok et un nombre attendu pour obtenir les identifiants, liens et métadonnées de collecte des vidéos publiques correspondantes.

Traduit · fr-FRVoir le texte original

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

Aperçu

Pour étudier la façon dont un sujet apparaît dans la recherche TikTok, il faut d’abord un ensemble fiable d’identifiants vidéo et de liens publics correspondants. Cette application transforme un mot-clé de recherche en une collection structurée d’éléments correspondants, en conservant le mot-clé et le contexte de collecte à côté de chaque identifiant afin que le jeu de données reste compréhensible après export ou jointure.

Le résultat sert d’index de découverte : il montre quelles vidéos publiques étaient associées à une marque, un produit, un sujet ou une campagne au moment de la collecte. Il convient particulièrement à la constitution d’ensembles de suivi reproductibles, à la comparaison des populations de contenus trouvées pour différents termes, et à la préparation d’identifiants et de liens pour une analyse ultérieure sans copier manuellement les éléments depuis les pages de recherche.

Notes sur les données

Chaque enregistrement représente un élément TikTok associé au mot-clé soumis. Les ID de contenu sont dédupliqués dans le jeu renvoyé. Mot-clé correspondant, élément source et ID métier conservent le contexte de collecte et peuvent se répéter sur de nombreux enregistrements de la même recherche. L’heure de collecte est renvoyée sans fuseau horaire ; elle ne doit pas être traitée comme un horodatage absolu inter-régions sans contexte supplémentaire. Le type de mot-clé décrit la nature de l’élément de recherche attaché à l’enregistrement.

La collection contient des identifiants, des liens vidéo publics et des métadonnées de collecte, pas les légendes, transcriptions, totaux d’engagement, commentaires ni un profil créateur complet. L’indicateur sans données distingue les métadonnées de recherche sans contenu correspondant des enregistrements correspondants ordinaires. Les contenus TikTok privés, supprimés ou autrement non recherchables ne sont pas couverts.

À quoi ressemble un résultat

Chaque ligne est une vidéo TikTok correspondante ou un indicateur sans données associé au mot-clé de recherche.

ID de contenuMot-clé correspondantURL du contenuHeure de collecteIndicateur sans données
7678592532162284813bluetooth earbudshttps://www.tiktok.com/@rebeccashao0/video/76785925321622848132026-08-27T15:13:22Non
7678160781283822879bluetooth earbudshttps://www.tiktok.com/@stitch.series6/video/76781607812838228792026-08-27T15:13:22Non

Le type de mot-clé, l’ID d’enregistrement de collecte, l’ID métier et l’élément source sont également disponibles lorsqu’ils sont fournis avec l’enregistrement.

Cas d’usage

  • Pour la découverte de sujets, regrouper les lignes par Mot-clé correspondant et compter les ID de contenu distincts afin de comparer la population de vidéos recherchables associée à chaque terme.
  • Pour le suivi, répéter une collecte par mot-clé, comparer les ensembles d’ID de contenu et utiliser l’Heure de collecte comme contexte fourni par la source pour les éléments nouvellement observés.
  • Pour vérifier la provenance, comparer Mot-clé correspondant, Élément source et ID métier avant de combiner des jeux de données.
  • Pour le contrôle qualité, ouvrir les valeurs URL du contenu et filtrer sur Indicateur sans données afin de séparer les métadonnées de recherche vide des enregistrements correspondants utilisables.

Périmètre et limites

Un mot-clé de recherche TikTok par tâche, avec un nombre de résultats attendu de 1 à 200 ; les résultats sont renvoyés par lots complets de 10 et peuvent être arrondis à l’entier supérieur ; la couverture se limite aux listes publiques de recherche par mot-clé TikTok.

  • Adapté pour
  • Lorsque vous avez besoin d’identifiants de contenu et de liens vidéo publics renvoyés par une recherche TikTok par mot-clé pour une marque, un produit, un sujet ou une campagne.
  • Lorsque vous avez besoin d’une liste structurée qui relie chaque vidéo correspondante à son mot-clé de recherche et à ses métadonnées de collecte.
  • À ne pas utiliser pour
  • Lorsque vous avez besoin de légendes, de transcriptions, de métriques d’engagement, de commentaires ou de profils créateurs complets.
  • Lorsque vous avez besoin d’une consultation immédiate d’un enregistrement unique plutôt que d’une collecte de mot-clé en arrière-plan.

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. 1Si aucun enregistrement correspondant n’est renvoyé, vérifiez le mot-clé ou essayez une expression plus courte et plus large.
  2. 2Conservez les enregistrements terminés après un succès partiel ; renvoyez la même entrée après une tâche échouée ou expirée.
  3. 3Réessayez plus tard après une limitation de débit, une indisponibilité temporaire ou un délai d’attente.
  4. 4En cas d’échec d’authentification, vérifiez la clé API configurée pour l’environnement d’exécution.

Entrée

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

  • Mot-clé de recherchekeywordRequisstring
    Marque, produit, sujet ou expression à rechercher sur TikTok. Chaque tâche accepte un mot-clé de 1 à 512 caractères.
    ExempleShokz
  • Nombre de résultats attenducrawl_countRequisinteger
    Nombre attendu de résultats de recherche, de 1 à 200. Les résultats sont renvoyés par lots complets de 10, le nombre réel peut donc être arrondi à l’entier supérieur.
    Plage1–200Exemple1

Sortie

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

  • ID de contenucontent_idstring
    Identifiant unique de la vidéo TikTok correspondante.
    Exemple7678592532162284813
  • URL du contenucontent_urlstring
    URL publique de la vidéo TikTok pour l’élément correspondant.
    Exemplehttps://www.tiktok.com/@rebeccashao0/video/7678592532162284813
  • Mot-clé correspondantkeywordstring
    Mot-clé de recherche associé à l’élément de contenu collecté.
    Exemplebluetooth earbuds
  • Type de mot-clékeyword_typestring
    Classification de l’élément de recherche associé à l’enregistrement.
    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 enregistrements renvoyés

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