# Chronometrica ou Streamers : choisir un Actor de recherche YouTube pour une liste de vidéos limitée

Nous recommandons Chronometrica si vous avez besoin d’une liste plafonnée de vidéos YouTube uniques, issue de requêtes fixes, avec une origine clairement indiquée pour chaque vidéo. Ses paramètres documentés conviennent bien à ce travail. Choisissez Streamers si vous avez besoin de ses filtres de recherche natifs, de ses options de sous-titres ou d’une extraction plus large. Le choix principal porte donc sur le décompte du panel de requêtes ou sur des paramètres de recherche plus riches. [Contrat de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper), [Contrat de Streamers](https://apify.com/streamers/youtube-scraper)

Un Actor est un programme hébergé de collecte de données. Ce comparatif porte sur notre Chronometrica YouTube Search Scraper et sur Streamers YouTube Scraper. Il vise un résultat précis : une petite liste de vidéos utiles dont vous pouvez expliquer les règles de collecte.

Un panel de recherche est un ensemble déclaré de requêtes dont les résultats sont collectés selon une règle fixe. Par exemple, vous pouvez collecter les résultats de 2 requêtes avec une limite commune. Le résultat peut servir à la recherche, à l’examen des sources ou à une analyse ultérieure des sujets. Il ne prouve pas une couverture complète de YouTube.

Les contrats publics utilisés ici ont été vérifiés le 20 octobre 2026. Les données d’entrée de l’exemple ont passé une vérification de conformité au schéma. Aucune collecte n’a été lancée avec ces données. L’exemple ne fournit donc aucune mesure du nombre de résultats obtenus ni des performances.

## Choisissez ce que représente une ligne avant de choisir l’Actor

Avant de comparer les paramètres, décidez ce que chaque ligne doit représenter.

Une ligne de vidéo unique représente un identifiant de vidéo distinct. Si la même vidéo apparaît pour 2 requêtes, une table de vidéos uniques conserve 1 seule ligne pour cette vidéo.

Une occurrence requête/vidéo correspond à l’apparition d’une vidéo pour une requête donnée. La même vidéo peut produire des occurrences distinctes lorsqu’elle apparaît pour différentes requêtes.

Ces unités répondent à des questions différentes. Une table de vidéos uniques répond à la question : « Quelles vidéos distinctes ce panel a-t-il collectées ? » Une table d’occurrences peut aider à répondre à la question : « Quelles vidéos sont apparues pour chaque requête ? » Vous ne pouvez pas supposer qu’une seule table répond entièrement aux 2 questions.

Chronometrica utilise `maxResults` pour plafonner le nombre de vidéos uniques enregistrées pour l’ensemble des requêtes. Il supprime les identifiants de vidéo répétés. Sa sortie inclut le contexte des requêtes dans des champs comme `rootQuery`, `query` et `querySource`. La sortie et le récapitulatif conservent aussi les décomptes par requête. Ces points forts sont utiles si vous avez besoin d’une liste de sources limitée, avec une origine enregistrée pour chaque vidéo conservée. [Contrat de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper)

La suppression des doublons a une conséquence directe. Une ligne conservée ne peut pas préserver toutes les occurrences répétées d’une paire requête/vidéo. Le contexte de la requête aide à expliquer une ligne. Mais 1 origine enregistrée ne constitue pas la liste complète de toutes les requêtes qui ont trouvé la vidéo.

Utilisez Chronometrica en toute confiance si le résultat attendu est cette liste de sources uniques. Si vous avez besoin d’une table complète des occurrences, vérifiez d’abord comment vous allez les conserver. Ne supposez pas qu’un export sans doublons les contient.

## Comparez les paramètres qui déterminent le choix

Les 2 Actors peuvent collecter des résultats de recherche YouTube et limiter leur nombre. La distinction utile tient à la règle de collecte requise par votre projet.

| Critère de choix | Chronometrica | Streamers |
| --- | --- | --- |
| Objectif de collecte dans ce comparatif | Panel de vidéos uniques avec un contexte de requête explicite | Recherche par mots-clés, URL directes et collecte plus large |
| Limites | Plafond global de vidéos uniques et contrôle du nombre de pages | Limites distinctes pour les vidéos classiques, les Shorts et les diffusions en direct |
| Ordre des requêtes | Traitement équilibré ou séquentiel | Vérifiez que son schéma correspond à votre règle de collecte |
| Paramètres de recherche natifs | Vérifiez les paramètres d’entrée documentés du panel | Tri, date, type de vidéo, durée et autres filtres |
| Options supplémentaires | Pour ce choix, concentrez-vous sur la collecte des résultats de recherche | Options de sous-titres et fonctions d’IA facultatives |

Sources : [Schéma d’entrée de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema), [Schéma d’entrée de Streamers](https://apify.com/streamers/youtube-scraper/input-schema).

Supposons que votre étude exige un filtre natif sur le mois écoulé ou sur la durée. Examinez les paramètres documentés de Streamers. Ne supposez pas que Chronometrica possède un paramètre équivalent. Appliquer un filtre après la collecte change les lignes enregistrées que vous conservez. Cela n’applique pas la même règle à la recherche effectuée à la source. [Schéma d’entrée de Streamers](https://apify.com/streamers/youtube-scraper/input-schema)

Ce comparatif ne démontre pas que Streamers est dépourvu de contexte de requête. La raison de choisir Chronometrica est son contrat explicite pour les panels. Choisissez selon la règle que vous devez appliquer, plutôt que selon le nombre de fonctions répertoriées.

## Définissez un petit panel avec des paramètres explicites

Commencez par une question à laquelle les vidéos collectées pourraient aider à répondre. Par exemple : « Quelles vidéos publiques dois-je examiner pour comprendre comment les créateurs expliquent 2 compétences de base en production vidéo ? »

Rédigez ensuite les requêtes d’origine. Gardez-les séparées des libellés ou des groupes thématiques ajoutés par la suite. Un autre lecteur pourra ainsi voir ce que vous avez demandé à la source de renvoyer.

Les données d’entrée pédagogiques suivantes utilisent 2 propositions de requêtes. Ce ne sont ni des termes de recherche mesurés ni des preuves de demande de la part des acheteurs.

```json
{
  "queries": [
    "video lighting basics",
    "home audio recording"
  ],
  "maxResults": 6,
  "maxPagesPerQuery": 1,
  "searchDistribution": "balanced",
  "enableQueryExpansion": false
}
```

Définissez un petit panel avec des paramètres explicites

Ces données d’entrée demandent au maximum 6 vidéos uniques enregistrées. Elles autorisent 1 page supplémentaire par requête et utilisent un traitement équilibré des requêtes. L’extension des requêtes est désactivée. Le panel déclaré contient donc 2 requêtes d’origine. Les données d’entrée ont été vérifiées par rapport au schéma public, mais aucune collecte n’a été lancée avec ces données. 6 est une limite, pas une promesse de résultats. [Schéma d’entrée de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema)

La règle sur les formats compte aussi. La valeur par défaut de `includeShorts` est `true`. Ce panel peut donc contenir des vidéos classiques et des Shorts, sauf si vous modifiez explicitement ce paramètre. Les autres valeurs par défaut du schéma restent actives, y compris l’enrichissement des métriques vidéo. Consignez ces valeurs par défaut dans la définition de votre panel. Sinon, une personne qui ne lit que la liste des requêtes risque de mal comprendre ce que vous avez inclus. [Schéma d’entrée de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema)

Une Task est une configuration d’entrée enregistrée. La [Task publique Export YouTube Search Results](https://apify.com/chronometrica/youtube-search-scraper/examples/export-youtube-search-results) fournit un point de départ. Avant la collecte, vérifiez que ses paramètres correspondent à votre règle écrite. Une configuration enregistrée vous aide à commencer. Votre question déclarée détermine toujours les paramètres d’entrée adaptés.

## Comprenez la collecte équilibrée et la collecte séquentielle

Chronometrica propose 2 valeurs pour `searchDistribution` : `balanced` et `sequential`. Le mode équilibré passe d’une requête à l’autre jusqu’à ce que le plafond global ou les limites de la source et du nombre de pages arrêtent la collecte. Le mode séquentiel collecte d’abord les résultats des premières requêtes. [Schéma d’entrée de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema)

Choisissez le traitement équilibré si chaque requête doit pouvoir contribuer avant que le plafond commun arrête la collecte. Ce mode est utile lorsque la liste des requêtes représente plusieurs aspects d’une même question de recherche.

Équilibré ne signifie pas que les nombres de vidéos enregistrées seront égaux. Les requêtes peuvent renvoyer des nombres différents de vidéos candidates utilisables. Elles peuvent aussi trouver la même vidéo. Avec 2 requêtes et un plafond de 6, ne promettez pas 3 vidéos enregistrées par requête.

Choisissez le traitement séquentiel si la priorité des requêtes fait partie de votre méthode. Placez la requête la plus importante en premier. Acceptez qu’elle puisse utiliser une plus grande part de la limite commune avant que les requêtes suivantes contribuent.

`resultsPerQuery` est un maximum par requête en mode séquentiel. Ne l’utilisez pas pour décrire un quota fixe en mode équilibré. Vérifiez le schéma actuel avant de l’ajouter à vos données d’entrée. [Schéma d’entrée de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema)

Ces choix influent sur l’interprétation de la liste enregistrée. Une faible contribution d’une requête peut résulter de la règle de collecte, du chevauchement des résultats ou d’une limite de la source. Elle ne prouve pas à elle seule que le sujet compte peu de vidéos pertinentes.

## Étudiez un exemple fictif de chevauchement

L’exemple suivant est fictif. Il présente des vidéos candidates pour aider le lecteur à raisonner. Il ne s’agit ni d’une sortie native de l’Actor, ni d’un ordre de collecte observé, ni d’un résultat testé.

La requête A a pour identifiants de vidéos candidates V1, V2 et V3. La requête B a V3, V4 et V5.

Il y a 6 occurrences requête/vidéo, car chaque requête a 3 vidéos candidates. Il y a 5 identifiants de vidéo uniques, car V3 apparaît dans les 2 listes.

Le nombre d’occurrences en double est :

`6 encounters − 5 unique video IDs = 1 duplicate encounter`

Le chevauchement contient 1 identifiant : V3. Un plafond global de 6 ne prouve pas que ces listes de vidéos candidates contiennent 6 vidéos distinctes. Elles n’en contiennent que 5.

Supposons maintenant que la ligne V3 conservée indique la requête A comme origine. Cette ligne aide à expliquer pourquoi V3 figure dans la liste de sources enregistrée. Elle ne conserve pas l’occurrence distincte de V3 issue de la requête B.

N’ajoutez pas une 2e ligne V3 sans preuve de cette occurrence. Dans cet exemple fictif, les 2 listes de vidéos candidates ont été fournies pour rendre la différence visible. Un véritable export sans doublons peut ne pas fournir cette preuve à lui seul.

Cette distinction compte lorsque vous mesurez la contribution des requêtes. Compter les lignes enregistrées par origine déclarée décrit ces lignes. Cela ne compte pas nécessairement toutes les vidéos candidates rencontrées par chaque requête.

Elle compte aussi lorsque vous étudiez le chevauchement. Vous ne pouvez pas retrouver le chevauchement exact de 2 ensembles complets de résultats de la source à partir de leur seul export sans doublons. Indiquez ce que les données disponibles permettent d’établir : les vidéos distinctes enregistrées, leur contexte enregistré et les limites de collecte connues.

Pour une liste destinée à l’examen des sources, ces unités peuvent être exactement celles qu’il faut. Pour une étude du chevauchement, vous avez besoin de preuves qui conservent les occurrences distinctes.

## Utilisez une méthode de collecte en 8 étapes

1. Consignez la question, les requêtes et les formats. Indiquez la décision que la liste doit vous aider à prendre. Copiez les chaînes exactes des requêtes d’origine dans votre dossier de recherche. Précisez si le panel inclut des vidéos classiques, des Shorts ou les 2. Si vous changez la question après avoir vu les résultats, consignez ce changement.
2. Fixez les limites de collecte. Choisissez le plafond global de vidéos uniques, le plafond de pages et la règle de répartition. Gardez l’extension des requêtes désactivée pour le premier panel contrôlé. Expliquez pourquoi le plafond correspond à l’examen que vous pouvez effectuer. Un plafond bas est utile si vous pouvez examiner chaque ligne enregistrée et corriger une requête mal adaptée avant d’élargir la collecte.
3. Vérifiez le schéma d’entrée natif. Confirmez que l’Actor accepte la règle dont vous avez besoin. N’inventez pas de quota par requête en mode équilibré, de filtre de date natif ou de suivi automatique de l’historique des classements. Si aucun paramètre documenté ne permet d’appliquer une règle requise, résolvez cette lacune avant de considérer le panel comme une preuve adaptée.
4. Collectez un petit échantillon et conservez son contexte. Gardez une référence à l’exécution, les paramètres déclarés, les identifiants de vidéo, les URL publiques et les requêtes d’origine. Chronometrica documente `postId` et `postUrl` en plus de ses champs de requête. Utilisez les identifiants pour identifier les vidéos et les URL pour ouvrir les sources publiques à examiner. [Contrat de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper)
5. Lisez les décomptes par requête et les conditions d’arrêt. Vérifiez la contribution de chaque requête et la raison de l’arrêt de la collecte. Une exécution terminée peut avoir atteint un plafond ou une limite de la source. Comparez le nombre de vidéos enregistrées au plafond déclaré. Mais ne considérez pas un nombre inférieur comme une preuve de couverture complète. Conservez la raison de l’arrêt avec le résultat.
6. Distinguez les occurrences des vidéos uniques enregistrées. Décrivez chaque décompte avec son unité réelle. Gardez visibles dans vos notes les requêtes sans contribution claire. Ne les retirez pas du panel déclaré sans le signaler. Conservez les valeurs manquantes comme telles. Ne remplacez pas un nombre ou une métrique inconnus par 0.
7. Vérifiez la pertinence avant l’analyse. Ouvrez les URL publiques enregistrées et vérifiez si les vidéos répondent à votre question. Consignez les décisions d’inclusion selon une règle constante. Si une requête renvoie surtout des contenus non pertinents, modifiez-la de façon explicite et créez une nouvelle définition du panel. Ne mélangez pas les résultats de requêtes modifiées sous une description restée identique.
8. Gardez les mêmes paramètres pour les observations répétées. Si vous relancez la collecte, conservez chaque exécution séparément avec sa date et ses paramètres. Cela facilite l’examen des changements. 1 seule collecte ne permet pas d’établir une tendance. Les changements dans les vidéos enregistrées doivent aussi être interprétés en tenant compte des plafonds, du chevauchement, de l’ordre de traitement des requêtes et des limites de la source.

Cette méthode vous donne plus qu’une liste de liens. Elle fournit une règle de collecte, des sources identifiables et une explication claire de ce que représentent les lignes. Cela suffit pour rendre le premier examen utile, sans prétendre couvrir tous les résultats de recherche.

## Interprétez les champs de position dans leurs limites

Chronometrica documente `pageIndex` et `pageRank` parmi ses champs de sortie. `pageRank` indique une position propre à la page de résultats. Ce n’est pas une position stable dans l’ensemble des résultats de la requête. [Contrat de Chronometrica](https://apify.com/chronometrica/youtube-search-scraper)

Conservez ces champs lorsqu’ils aident à expliquer les données renvoyées. Ne présentez pas une position propre à une page comme un classement global établi. Répéter la collecte ne supprime pas cette limite.

La même prudence s’applique aux informations disponibles sur les vidéos et les chaînes. Gardez les valeurs fournies par la source et conservez les valeurs inconnues comme telles. Une métrique vide ne montre pas que la vidéo n’a aucune activité.

Après avoir vérifié la pertinence, vous pouvez utiliser la liste de sources pour une autre question. Par exemple, vous pouvez comparer les explications fournies par les vidéos sélectionnées. Notre [méthode pour repérer les lacunes thématiques sur YouTube](/fr/articles/reperer-les-lacunes-thematiques-sur-youtube/) décrit cette étape suivante. Traitez séparément le choix de l’outil de collecte : établissez d’abord ce que vous avez collecté, puis déterminez ce que le contenu montre.

## Commencez avec 2 requêtes et examinez 1 ligne

Choisissez 2 requêtes pertinentes et rédigez la question à laquelle elles doivent répondre. Fixez un petit plafond global, choisissez un traitement équilibré ou séquentiel et précisez la règle sur les formats. Utilisez [Chronometrica YouTube Search Scraper](https://apify.com/chronometrica/youtube-search-scraper) si ce contrat de collecte limitée de vidéos uniques convient à votre travail.

Lancez la collecte du petit panel, puis examinez 1 ligne conservée. Vérifiez son identifiant de vidéo, son URL publique et sa requête d’origine enregistrée par rapport à vos notes de collecte. Lisez les décomptes par requête et la condition d’arrêt avant d’élargir la collecte. Si le résultat correspond à votre règle déclarée, agrandissez le panel en sachant clairement ce que représente chaque ligne enregistrée.

## Sources et lectures complémentaires

- [Chronometrica YouTube Search Scraper : contrat public](https://apify.com/chronometrica/youtube-search-scraper)
- [Chronometrica : schéma d’entrée actuel](https://apify.com/chronometrica/youtube-search-scraper/input-schema)
- [Export YouTube Search Results : Task publique](https://apify.com/chronometrica/youtube-search-scraper/examples/export-youtube-search-results)
- [Streamers YouTube Scraper : contrat public](https://apify.com/streamers/youtube-scraper)
- [Streamers : schéma d’entrée actuel](https://apify.com/streamers/youtube-scraper/input-schema)
- [Stack Overflow : question observée sur la collecte des résultats de recherche YouTube](https://stackoverflow.com/questions/45362731/how-can-i-scrape-videos-from-a-youtube-search)