The explorer and the API
Four access tiers, their limits, the R and Python clients, the endpoints.
Four access tiers
The data explorer lets you browse videos, transcripts and comments. You can filter by channel, date or classifier, and search by words or by meaning. The REST API gives access to the same tables. Both require a personal key, issued by the team with an access tier.
Metadata
metadataVideos, channels, metadata history, aggregates, classifier registry, automatic summaries. Search in titles.
Analysis 1
analyst_1The previous tier, plus the structure of comments, transcripts and sentences (identifiers, dates, classifier scores), with no text and no comment authors.
Analysis 2
analyst_2The previous tier, plus the text of transcripts, speaker turns and sentences. Search in transcripts, by words or by meaning.
Research
researcherAll the data, including the text of comments and their authors’ pseudonyms, corpus exports and embeddings.
Usage limits by tier
| Limit | Metadata | Analysis 1 | Analysis 2 | Research |
|---|---|---|---|---|
| Requests per day | 100 | 500 | 2,000 | 10,000 |
| Requests in total | 5,000 | 25,000 | 100,000 | No limit |
| Searches and analyses per day | — | — | 50 | 500 |
| Searches and analyses in total | — | — | 500 | 5,000 |
| Transcript requests per day | Not included | — | 100 | 1,000 |
| Transcript requests in total | Not included | — | 1,000 | — |
| Exports per day | Not included | Not included | Not included | 50 |
| Exports in total | Not included | Not included | Not included | 500 |
These are the default limits for a new key. The team can adjust them for a project. Every call counts as a request, including searches and exports. Calls that read transcripts, speaker turns, sentences or embeddings also count as transcript requests. A dash means there is no separate limit; only the request limit applies.
remotes::install_github("antoinelemor/r-youpol-data")
library(youpoldata)
cli <- youpol_client() # reads YOUPOL_TOKEN
youpol_videos(cli, country = "QC",
order = "video_views.desc", limit = 10)pip install git+https://github.com/antoinelemor/youpol-client.gitDocumentation and examples in the repository: github.com/antoinelemor/youpol-client