Données · 02

L’explorateur et l’API

Quatre niveaux d’accès, leurs plafonds, les clients R et Python, les adresses.

Explorateur et API

Quatre niveaux d’accès

L’explorateur de données permet de parcourir les vidéos, les transcriptions et les commentaires. On peut y filtrer par chaîne, par date ou par classifieur, et chercher par mots ou par sens. L’API REST donne accès aux mêmes tables. Les deux demandent une clé personnelle, attribuée par l’équipe avec un niveau d’accès.

Métadonnées

metadata
100requêtes par jour

Vidéos, chaînes, historique des métadonnées, agrégats, registre des classifieurs, résumés automatiques. Recherche dans les titres.

Analyse 1

analyst_1
500requêtes par jour

Le niveau précédent, plus la structure des commentaires, des transcriptions et des phrases (identifiants, dates, scores des classifieurs), sans aucun texte ni auteur de commentaire.

Analyse 2

analyst_2
2 000requêtes par jour

Le niveau précédent, plus le texte des transcriptions, des tours de parole et des phrases. Recherche dans les transcriptions, par mots ou par sens.

Recherche

researcher
10 000requêtes par jour

Toutes les données, y compris le texte des commentaires et le pseudonyme de leurs auteurs, les exports de corpus et les plongements vectoriels.

Plafonds d’utilisation par niveau
PlafondMétadonnéesAnalyse 1Analyse 2Recherche
Requêtes par jour1005002 00010 000
Requêtes au total5 00025 000100 000Sans plafond
Recherches et analyses par jour——50500
Recherches et analyses au total——5005 000
Accès aux transcriptions par jourNon inclus—1001 000
Accès aux transcriptions au totalNon inclus—1 000—
Exports par jourNon inclusNon inclusNon inclus50
Exports au totalNon inclusNon inclusNon inclus500

Ces plafonds sont attribués par défaut à une nouvelle clé. L’équipe peut les adapter à un projet. Chaque appel compte comme une requête, y compris les recherches et les exports. Les appels qui lisent les transcriptions, les tours de parole, les phrases ou les plongements comptent aussi comme accès aux transcriptions. Un tiret signale l’absence de plafond propre ; seul le plafond des requêtes s’applique.

R · youpoldata
remotes::install_github("antoinelemor/r-youpol-data")
library(youpoldata)
cli <- youpol_client()   # lit YOUPOL_TOKEN
youpol_videos(cli, country = "QC",
              order = "video_views.desc", limit = 10)

github.com/antoinelemor/r-youpol-data

Python · youpol-client
pip install git+https://github.com/antoinelemor/youpol-client.git

Documentation et exemples dans le dépôt : github.com/antoinelemor/youpol-client

Article de présentation