Submit a TikTok username and retrieve its collected video records after the collection task finishes
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
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 contenu | Mot-clé correspondant | URL du contenu | Heure de collecte | Indicateur sans données |
|---|---|---|---|---|
| 7678592532162284813 | bluetooth earbuds | https://www.tiktok.com/@rebeccashao0/video/7678592532162284813 | 2026-08-27T15:13:22 | Non |
| 7678160781283822879 | bluetooth earbuds | https://www.tiktok.com/@stitch.series6/video/7678160781283822879 | 2026-08-27T15:13:22 | Non |
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.
- 1Si aucun enregistrement correspondant n’est renvoyé, vérifiez le mot-clé ou essayez une expression plus courte et plus large.
- 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.
- 3Réessayez plus tard après une limitation de débit, une indisponibilité temporaire ou un délai d’attente.
- 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 recherche
keywordRequisstringMarque, produit, sujet ou expression à rechercher sur TikTok. Chaque tâche accepte un mot-clé de 1 à 512 caractères.ExempleShokz - Nombre de résultats attendu
crawl_countRequisintegerNombre 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 contenu
content_idstringIdentifiant unique de la vidéo TikTok correspondante.Exemple7678592532162284813 - URL du contenu
content_urlstringURL publique de la vidéo TikTok pour l’élément correspondant.Exemplehttps://www.tiktok.com/@rebeccashao0/video/7678592532162284813 - Mot-clé correspondant
keywordstringMot-clé de recherche associé à l’élément de contenu collecté.Exemplebluetooth earbuds - Type de mot-clé
keyword_typestringClassification 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.
{
"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": {
"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
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.
Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.
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éditsEssayer maintenant
Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.