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 l'auteur. 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.
| Champ | Nom métier | Type | Requis | Défaut | Énum / Contraintes | Exemple | Description |
|---|---|---|---|---|---|---|---|
| keyword | Mot-clé de recherche | string | Oui | — | — | Shokz | Marque, produit, sujet ou expression à rechercher sur TikTok. Chaque tâche accepte un mot-clé de 1 à 512 caractères. |
| crawl_count | Nombre de résultats attendu | integer | Oui | — | 1–200 | 1 | 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. |
Sortie
Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.
| Champ | Nom métier | Type | Exemple | Description |
|---|---|---|---|---|
| content_id | ID de contenu | string | 7678592532162284813 | Identifiant unique de la vidéo TikTok correspondante. |
| content_url | URL du contenu | string | https://www.tiktok.com/@rebeccashao0/video/7678592532162284813 | URL publique de la vidéo TikTok pour l’élément correspondant. |
| keyword | Mot-clé correspondant | string | bluetooth earbuds | Mot-clé de recherche associé à l’élément de contenu collecté. |
| keyword_type | Type de mot-clé | string | keyword | Classification de l’élément de recherche associé à l’enregistrement. |
| crawl_time | Heure de collecte | string | 2026-08-27T15:13:22 | Horodatage associé à l’enregistrement collecté ; la source ne précise pas de fuseau horaire. |
| cur_id | ID d’enregistrement de collecte | string | 6a8fe396b799f44efa7f2ff0 | Identifiant unique de cette ligne collectée ; il peut différer de l’ID de contenu de la vidéo TikTok. |
| biz_id | ID métier | string | bluetooth earbuds | Identifiant de regroupement métier renvoyé avec l’enregistrement collecté. |
| source_item | Élément source | string | bluetooth earbuds | Élément de mot-clé associé à la collecte qui a produit cet enregistrement. |
| no_data | Indicateur sans données | boolean | false | Indique si cet élément de recherche n’a produit aucun enregistrement correspondant. |
Schema de l'enregistrement
La sortie est renvoyée enregistrement par enregistrement. detail.output.idFieldHint
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "ID de contenu",
"description": "Identifiant unique de la vidéo TikTok correspondante.",
"prefill": "7678592532162284813"
},
"content_url": {
"type": "string",
"title": "URL du contenu",
"description": "URL publique de la vidéo TikTok pour l’élément correspondant.",
"prefill": "https://www.tiktok.com/@rebeccashao0/video/7678592532162284813"
},
"keyword": {
"type": "string",
"title": "Mot-clé correspondant",
"description": "Mot-clé de recherche associé à l’élément de contenu collecté.",
"prefill": "bluetooth earbuds"
},
"keyword_type": {
"type": "string",
"title": "Type de mot-clé",
"description": "Classification de l’élément de recherche associé à l’enregistrement.",
"prefill": "keyword"
},
"crawl_time": {
"type": "string",
"title": "Heure de collecte",
"description": "Horodatage associé à l’enregistrement collecté ; la source ne précise pas de fuseau horaire.",
"prefill": "2026-08-27T15:13:22"
},
"cur_id": {
"type": "string",
"title": "ID d’enregistrement de collecte",
"description": "Identifiant unique de cette ligne collectée ; il peut différer de l’ID de contenu de la vidéo TikTok.",
"prefill": "6a8fe396b799f44efa7f2ff0"
},
"biz_id": {
"type": "string",
"title": "ID métier",
"description": "Identifiant de regroupement métier renvoyé avec l’enregistrement collecté.",
"prefill": "bluetooth earbuds"
},
"source_item": {
"type": "string",
"title": "Élément source",
"description": "Élément de mot-clé associé à la collecte qui a produit cet enregistrement.",
"prefill": "bluetooth earbuds"
},
"no_data": {
"type": "boolean",
"title": "Indicateur sans données",
"description": "Indique si cet élément de recherche n’a produit aucun enregistrement correspondant.",
"prefill": false
}
},
"required": [],
"additionalProperties": 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.
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": {
"hello_moto__tiktok-keyword-list": {
"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. (Le prompt demande à l'IA de vous réclamer votre API Key, afin que les identifiants ne finissent jamais dans l'historique de conversation ni dans des configs partagées.)
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 enregistrement ; toute unité incomplète est arrondie à 10 enregistrement.
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éditsData Apps associées
Ajoutez cette App et les recommandations ci-dessous à une même collection et générez une config MCP prête à brancher sur votre client IA.Regrouper ces Apps →
Détail vidéo TikTok
Soumettez jusqu'à 200 URL de vidéos TikTok et récupérez les détails publics de la vidéo, du compte, de l'engagement et des médias
hello_motoÀ partir de 0,0015 $US / enregistrementCommentaires vidéo TikTok
Indiquez un identifiant de contenu TikTok et un nombre attendu de commentaires pour recevoir les commentaires publics, les auteurs, les interactions et les heures de publication
hello_motoÀ partir de 0,002 $US / 20 enregistrementInfos de compte TikTok
Collecte les détails de profil public, les indicateurs d'audience et les signaux de vérification pour un ou plusieurs comptes TikTok
hello_motoÀ partir de 0,0015 $US / enregistrementEssayer maintenant
Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.