Recherche par mot-clé YouTube
Indiquez un mot-clé YouTube et un nombre attendu pour obtenir les vidéos publiques correspondantes, les chaînes, les vues et les dates de publication.
Traduit · fr-FRVoir le texte original
Aperçu
Sur YouTube, les spectateurs choisissent une vidéo d'après le titre, la chaîne, les vues et la fraîcheur. Cette App transforme un mot-clé de recherche public en tableau de ces listes, pour que le travail de marque, de concurrence et de contenu parte de la même vue qu'un spectateur.
Le mot-clé reste à côté de chaque vidéo, pour que les comparaisons restent liées à la même requête. Ce n'est pas un substitut aux commentaires, aux transcriptions ou à une page de chaîne complète.
Notes sur les données
Chaque ligne est un élément public de recherche YouTube par mot-clé. Les lignes sont triées par Publié le du plus récent au plus ancien, et le même ID vidéo n'est gardé qu'une fois. Nombre de vues et Texte du nombre de vues sont les chiffres de la carte de recherche, pas des totaux normalisés d'un tableau de bord. Durée affichée est l'horloge du lecteur, Durée ms la même durée en millisecondes sous forme de texte. Publié le et Collecté le n'ont pas de fuseau. Publication affichée est la phrase relative de la carte, par exemple 5 days ago. Statut du contenu est le statut source renvoyé. Images de couverture, Miniature de chaîne, Badges vidéo et les listes similaires sont du texte JSON, pas des fichiers image. Mot-clé, ID métier et Élément source répètent le contexte de recherche sur les lignes de la même requête.
Les commentaires, transcriptions, vidéos privées ou non répertoriées et la page d'accueil complète d'une chaîne ne sont pas couverts. Bannière de chaîne, Description de la chaîne, URL de la chaîne, Nombre d'abonnés et Résumé vidéo sont souvent vides sur les listes de recherche. Un Marqueur sans données distingue un mot-clé sans vidéos des lignes vidéo ordinaires.
À quoi ressemble un résultat
Chaque ligne est un élément public de recherche YouTube.
| Titre de la vidéo | Nom de la chaîne | URL de la vidéo | Nombre de vues | Publié le | Durée affichée |
|---|---|---|---|---|---|
| Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison | Mariselle Hartwell | https://www.youtube.com/watch?v=EpGip-GW7g4 | 215 | 2026-09-04T18:42:58 | 4:23 |
| Opening my new OpenRun by Shokz Bone Conduction Sport Headphones | Type1Reframed | https://www.youtube.com/watch?v=Ccj5oDYwCEo | 2 | 2026-09-05T18:42:58 | 3:48 |
ID vidéo, ID de chaîne, Type de contenu et Description de la vidéo sont aussi disponibles lorsque l'élément les affiche.
Cas d'usage
- Pour la part de recherche, groupez les lignes par Mot-clé et parcourez Titre de la vidéo, Nom de la chaîne et Nombre de vues pour voir quelles vidéos occupent les premiers résultats.
- Pour le suivi concurrentiel, comparez Nom de la chaîne, Chaîne vérifiée et Publié le pour voir qui publie sur la même requête.
- Pour la planification de contenu, lisez Titre de la vidéo avec Durée affichée et Nombre de vues pour séparer les explications courtes des reviews plus longues.
- Pour une page d'atterrissage, gardez URL de la vidéo et Images de couverture avec Identifiant de chaîne afin de reconstruire les cartes publiques que voient les spectateurs.
Périmètre et limites
Un mot-clé de recherche YouTube par tâche, avec un nombre attendu de 1 à 600 ; les résultats reviennent par lots complets de 20 et peuvent être arrondis ; uniquement les listes publiques de recherche par mot-clé, la plateforme renvoie au plus 600 vidéos.
- Adapté pour
- Lorsque vous avez besoin des listes publiques de recherche YouTube pour un mot-clé, y compris titres, chaînes, vues et dates de publication.
- Lorsque vous devez comparer la visibilité des vidéos concurrentes pour le même mot-clé.
- À ne pas utiliser pour
- Si vous avez besoin des commentaires, des transcriptions ou de la page d'accueil complète d'une chaîne — cette App ne renvoie que les listes de recherche par mot-clé.
- Si vous avez besoin de données YouTube privées, non répertoriées ou après connexion — cette App couvre uniquement les résultats de recherche publics.
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 aucune vidéo n'est renvoyée, essayez un mot-clé plus large ou plus courant et confirmez que la requête est searchable sur YouTube public.
- 2Conservez les enregistrements terminés après un succès partiel ; renvoyez la même saisie 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.
- 4Si l'authentification échoue, 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 YouTube. Chaque tâche accepte un mot-clé de 1 à 512 caractères. |
| crawl_count | Nombre de résultats attendu | integer | Oui | — | 1–600 | 1 | Nombre de vidéos attendu, de 1 à 600. Les résultats reviennent par lots complets de 20, donc le nombre réel peut être arrondi. Un lot partiel est quand même facturé comme 20 vidéos. |
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 |
|---|---|---|---|---|
| account_badge_list | Badges de chaîne | string | — | Badges affichés sur la chaîne, renvoyés en texte JSON s'ils existent. |
| account_display_id | Identifiant de chaîne | string | @MariselleHartwell | Identifiant public de la chaîne, avec le préfixe @ s'il est affiché. |
| account_id | ID de chaîne | string | UCzIWiqlJ3CakJ7QpNaPHJNw | Identifiant YouTube stable de la chaîne éditrice. |
| account_name | Nom de la chaîne | string | Mariselle Hartwell | Nom affiché de la chaîne qui a publié cet élément. |
| article_type | Type de contenu | string | video | Type d'élément renvoyé, par exemple video ou short. |
| biz_id | ID métier | string | Shokz | Identifiant métier de l'élément de recherche à l'origine de cet enregistrement. |
| channel_banner_url | Bannière de chaîne | string | — | URL de la bannière de la chaîne lorsque la liste de recherche l'inclut. |
| channel_description | Description de la chaîne | string | — | Description publique de la chaîne lorsque la liste de recherche l'inclut. |
| channel_description_links | Liens de la chaîne | string | — | Liens de la description de la chaîne, en texte JSON s'ils existent. |
| channel_thumbnail_list | Miniature de chaîne | string | [{"height": 68, "url": "https://yt3.ggpht.com/NosIQPZfiNCw_pXuwLWpNbx0T9jyIDMVJePbO6LVZGjKXz9ppAO49vmpqNyMGBDj96AufI9PMg=s68-c-k-c0x00ffffff-no-rj", "width": 68}] | Liste d'avatars de la chaîne, en texte JSON s'ils existent. |
| channel_total_videos | Nombre de vidéos de la chaîne | string | — | Nombre public de vidéos de la chaîne lorsque la liste de recherche l'inclut. |
| channel_url | URL de la chaîne | string | — | URL publique de la chaîne lorsque la liste de recherche l'inclut. |
| co_creator_info | Infos co-créateur | string | — | Détails du co-créateur, en texte JSON s'ils existent. |
| content_badge_list | Badges vidéo | string | ["New"] | Badges de la carte, en texte JSON s'ils existent. |
| content_id | ID vidéo | string | EpGip-GW7g4 | Identifiant YouTube stable de cette vidéo. |
| content_rich_thumbnail_list | Miniature enrichie | string | [{"height": 180, "url": "https://i.ytimg.com/an_webp/EpGip-GW7g4/mqdefault_6s.webp?du=3000&sqp=CLDUhNUG&rs=AOn4CLA9KhjVt8CHIDcWbqhbSz4rCcFjXQ", "width": 320}] | Miniatures enrichies ou animées, en texte JSON si présentes. |
| content_status | Statut du contenu | string | RUNNING | Texte de statut source de l'élément au moment de la collecte. |
| content_text | Description de la vidéo | string | Shokz #OpenRunAir2 #BoneConduction In this comprehensive comparison, we dive deep into the differences between the new ... | Description courte ou extrait affiché pour cet élément. |
| content_title | Titre de la vidéo | string | Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison | Titre affiché sur la carte de recherche YouTube publique. |
| content_url | URL de la vidéo | string | https://www.youtube.com/watch?v=EpGip-GW7g4 | URL publique de lecture de cet élément. |
| cover_image_list | Images de couverture | string | [{"height": 202, "url": "https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCOgCEMoBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLC3oubUMvaAVXixL45NhWFyGYHaWw", "width": 360}, {"height": 404, "url": "https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBcz_YqYgJfo5VIlQ0RXqnFnu4c1Q", "width": 720}] | Liste d'images de couverture, en texte JSON si présente. |
| crawl_time | Collecté le | string | 2026-09-09T18:42:58 | Horodatage de collecte sans décalage de fuseau. |
| is_collaboration | Collaboration | boolean | false | Indique si l'élément est marqué comme collaboration. Oui si true. |
| is_verified | Chaîne vérifiée | boolean | false | Indique si la chaîne est vérifiée. Oui si true. |
| is_verified_artist | Artiste vérifié | boolean | false | Indique si la chaîne est un artiste vérifié. Oui si true. |
| keyword | Mot-clé | string | Shokz | Mot-clé de recherche à l'origine de cet élément. |
| keyword_type | Type de mot-clé | string | keyword | Type d'élément de recherche renvoyé, par exemple keyword. |
| list_order | Rang dans la liste | integer | 0 | Position dans la liste collectée, lorsqu'elle est renvoyée. |
| number_of_subscribers | Nombre d'abonnés | string | — | Texte public du nombre d'abonnés lorsque la liste l'inclut. |
| publish_time | Publié le | string | 2026-09-04T18:42:58 | Horodatage de publication sans décalage de fuseau. |
| raw_duration | Durée affichée | string | 4:23 | Durée affichée sur la carte, par exemple 4:23. |
| raw_publish_time | Publication affichée | string | 5 days ago | Phrase relative de publication sur la carte, par exemple 5 days ago. |
| video_duration | Durée ms | string | 263000 | Durée de la vidéo en millisecondes, renvoyée en texte. |
| video_summary | Résumé vidéo | string | — | Résumé plus long lorsque le résultat de recherche l'inclut. |
| view_count | Nombre de vues | string | 215 | Nombre de vues affiché sur la carte, en texte. |
| view_count_text | Texte du nombre de vues | string | 215 views | Phrase du nombre de vues sur la carte, par exemple 215 views. |
| task_item | Élément source | string | Shokz | Élément de recherche soumis à l'origine de cette ligne. |
| no_data | Marqueur sans données | boolean | false | Indique si cette ligne marque un élément sans vidéos. Oui si true. |
Schema de l'enregistrement
La sortie est renvoyée enregistrement par enregistrement. detail.output.idFieldHint
{
"type": "object",
"properties": {
"account_badge_list": {
"type": "string",
"title": "Badges de chaîne",
"description": "Badges affichés sur la chaîne, renvoyés en texte JSON s'ils existent."
},
"account_display_id": {
"type": "string",
"title": "Identifiant de chaîne",
"description": "Identifiant public de la chaîne, avec le préfixe @ s'il est affiché.",
"prefill": "@MariselleHartwell"
},
"account_id": {
"type": "string",
"title": "ID de chaîne",
"description": "Identifiant YouTube stable de la chaîne éditrice.",
"prefill": "UCzIWiqlJ3CakJ7QpNaPHJNw"
},
"account_name": {
"type": "string",
"title": "Nom de la chaîne",
"description": "Nom affiché de la chaîne qui a publié cet élément.",
"prefill": "Mariselle Hartwell"
},
"article_type": {
"type": "string",
"title": "Type de contenu",
"description": "Type d'élément renvoyé, par exemple video ou short.",
"prefill": "video"
},
"biz_id": {
"type": "string",
"title": "ID métier",
"description": "Identifiant métier de l'élément de recherche à l'origine de cet enregistrement.",
"prefill": "Shokz"
},
"channel_banner_url": {
"type": "string",
"title": "Bannière de chaîne",
"description": "URL de la bannière de la chaîne lorsque la liste de recherche l'inclut."
},
"channel_description": {
"type": "string",
"title": "Description de la chaîne",
"description": "Description publique de la chaîne lorsque la liste de recherche l'inclut."
},
"channel_description_links": {
"type": "string",
"title": "Liens de la chaîne",
"description": "Liens de la description de la chaîne, en texte JSON s'ils existent."
},
"channel_thumbnail_list": {
"type": "string",
"title": "Miniature de chaîne",
"description": "Liste d'avatars de la chaîne, en texte JSON s'ils existent.",
"prefill": "[{\"height\": 68, \"url\": \"https://yt3.ggpht.com/NosIQPZfiNCw_pXuwLWpNbx0T9jyIDMVJePbO6LVZGjKXz9ppAO49vmpqNyMGBDj96AufI9PMg=s68-c-k-c0x00ffffff-no-rj\", \"width\": 68}]"
},
"channel_total_videos": {
"type": "string",
"title": "Nombre de vidéos de la chaîne",
"description": "Nombre public de vidéos de la chaîne lorsque la liste de recherche l'inclut."
},
"channel_url": {
"type": "string",
"title": "URL de la chaîne",
"description": "URL publique de la chaîne lorsque la liste de recherche l'inclut."
},
"co_creator_info": {
"type": "string",
"title": "Infos co-créateur",
"description": "Détails du co-créateur, en texte JSON s'ils existent."
},
"content_badge_list": {
"type": "string",
"title": "Badges vidéo",
"description": "Badges de la carte, en texte JSON s'ils existent.",
"prefill": "[\"New\"]"
},
"content_id": {
"type": "string",
"title": "ID vidéo",
"description": "Identifiant YouTube stable de cette vidéo.",
"prefill": "EpGip-GW7g4"
},
"content_rich_thumbnail_list": {
"type": "string",
"title": "Miniature enrichie",
"description": "Miniatures enrichies ou animées, en texte JSON si présentes.",
"prefill": "[{\"height\": 180, \"url\": \"https://i.ytimg.com/an_webp/EpGip-GW7g4/mqdefault_6s.webp?du=3000&sqp=CLDUhNUG&rs=AOn4CLA9KhjVt8CHIDcWbqhbSz4rCcFjXQ\", \"width\": 320}]"
},
"content_status": {
"type": "string",
"title": "Statut du contenu",
"description": "Texte de statut source de l'élément au moment de la collecte.",
"prefill": "RUNNING"
},
"content_text": {
"type": "string",
"title": "Description de la vidéo",
"description": "Description courte ou extrait affiché pour cet élément.",
"prefill": "Shokz #OpenRunAir2 #BoneConduction In this comprehensive comparison, we dive deep into the differences between the new ..."
},
"content_title": {
"type": "string",
"title": "Titre de la vidéo",
"description": "Titre affiché sur la carte de recherche YouTube publique.",
"prefill": "Shokz OpenRun Air 2 vs OpenRun Air Headphones Review 2026: Comparison"
},
"content_url": {
"type": "string",
"title": "URL de la vidéo",
"description": "URL publique de lecture de cet élément.",
"prefill": "https://www.youtube.com/watch?v=EpGip-GW7g4"
},
"cover_image_list": {
"type": "string",
"title": "Images de couverture",
"description": "Liste d'images de couverture, en texte JSON si présente.",
"prefill": "[{\"height\": 202, \"url\": \"https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCOgCEMoBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLC3oubUMvaAVXixL45NhWFyGYHaWw\", \"width\": 360}, {\"height\": 404, \"url\": \"https://i.ytimg.com/vi/EpGip-GW7g4/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBcz_YqYgJfo5VIlQ0RXqnFnu4c1Q\", \"width\": 720}]"
},
"crawl_time": {
"type": "string",
"title": "Collecté le",
"description": "Horodatage de collecte sans décalage de fuseau.",
"prefill": "2026-09-09T18:42:58"
},
"is_collaboration": {
"type": "boolean",
"title": "Collaboration",
"description": "Indique si l'élément est marqué comme collaboration. Oui si true.",
"prefill": false
},
"is_verified": {
"type": "boolean",
"title": "Chaîne vérifiée",
"description": "Indique si la chaîne est vérifiée. Oui si true.",
"prefill": false
},
"is_verified_artist": {
"type": "boolean",
"title": "Artiste vérifié",
"description": "Indique si la chaîne est un artiste vérifié. Oui si true.",
"prefill": false
},
"keyword": {
"type": "string",
"title": "Mot-clé",
"description": "Mot-clé de recherche à l'origine de cet élément.",
"prefill": "Shokz"
},
"keyword_type": {
"type": "string",
"title": "Type de mot-clé",
"description": "Type d'élément de recherche renvoyé, par exemple keyword.",
"prefill": "keyword"
},
"list_order": {
"type": "integer",
"title": "Rang dans la liste",
"description": "Position dans la liste collectée, lorsqu'elle est renvoyée.",
"prefill": 0
},
"number_of_subscribers": {
"type": "string",
"title": "Nombre d'abonnés",
"description": "Texte public du nombre d'abonnés lorsque la liste l'inclut."
},
"publish_time": {
"type": "string",
"title": "Publié le",
"description": "Horodatage de publication sans décalage de fuseau.",
"prefill": "2026-09-04T18:42:58"
},
"raw_duration": {
"type": "string",
"title": "Durée affichée",
"description": "Durée affichée sur la carte, par exemple 4:23.",
"prefill": "4:23"
},
"raw_publish_time": {
"type": "string",
"title": "Publication affichée",
"description": "Phrase relative de publication sur la carte, par exemple 5 days ago.",
"prefill": "5 days ago"
},
"video_duration": {
"type": "string",
"title": "Durée ms",
"description": "Durée de la vidéo en millisecondes, renvoyée en texte.",
"prefill": "263000"
},
"video_summary": {
"type": "string",
"title": "Résumé vidéo",
"description": "Résumé plus long lorsque le résultat de recherche l'inclut."
},
"view_count": {
"type": "string",
"title": "Nombre de vues",
"description": "Nombre de vues affiché sur la carte, en texte.",
"prefill": "215"
},
"view_count_text": {
"type": "string",
"title": "Texte du nombre de vues",
"description": "Phrase du nombre de vues sur la carte, par exemple 215 views.",
"prefill": "215 views"
},
"task_item": {
"type": "string",
"title": "Élément source",
"description": "Élément de recherche soumis à l'origine de cette ligne.",
"prefill": "Shokz"
},
"no_data": {
"type": "boolean",
"title": "Marqueur sans données",
"description": "Indique si cette ligne marque un élément sans vidéos. Oui si true.",
"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__youtube-keyword-list": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/youtube-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 20 enregistrement ; toute unité incomplète est arrondie à 20 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éditsEssayer maintenant
Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.