Skip to contents

Get popular / trending lists

Usage

lists_popular(limit = 10, type = c("personal", "official"))

lists_trending(limit = 10, type = c("personal", "official"))

Source

lists_popular() wraps endpoint /lists/popular/:type.

lists_trending() wraps endpoint /lists/trending/:type.

Arguments

limit

integer(1) [10L]: Number of items to return. Must be greater than 0 and will be coerced via as.integer().

type

character(1) ["personal"]: The kind of lists to return, one of "personal" (user-created lists) or "official" (Trakt-curated lists). The trakt.tv API requires this path segment; a request without it returns an empty (HTTP 204) response.

Value

A tibble(). If the function has a limit parameter (defaulting to 10), this will be the (maximum) number of rows of the tibble. If there are no results (or the API is unreachable), an empty tibble() is returned.

Examples

lists_popular()
#> # A tibble: 10 × 32
#>    name      description privacy share_link type  display_numbers allow_comments
#>    <chr>     <chr>       <chr>   <chr>      <chr> <lgl>           <lgl>         
#>  1 MARVEL C… "**UPDATED… public  ""         pers… TRUE            TRUE          
#>  2 IMDB: To… "Top 250 m… public  ""         pers… TRUE            TRUE          
#>  3 IMDB: To… "Top 250 T… public  ""         pers… TRUE            TRUE          
#>  4 Best Min… "What’s a … public  ""         pers… FALSE           TRUE          
#>  5 1001 Gre… "/u/StopRe… public  ""         pers… TRUE            TRUE          
#>  6 1001 Mov… "> 1001 Mo… public  ""         pers… TRUE            TRUE          
#>  7 True Cri… "This isn'… public  ""         pers… FALSE           TRUE          
#>  8 Mindfuck  "The objec… public  ""         pers… FALSE           TRUE          
#>  9 DC Unive… ""          public  ""         pers… TRUE            TRUE          
#> 10 Great Mo… "Every yea… public  ""         pers… FALSE           TRUE          
#> # ℹ 25 more variables: sort_by <chr>, sort_how <chr>, created_at <dttm>,
#> #   updated_at <dttm>, item_count <int>, comment_count <int>, likes <int>,
#> #   slug <chr>, trakt <chr>, username <chr>, private <lgl>, deleted <lgl>,
#> #   joined_at <dttm>, location <chr>, about <chr>, user_name <chr>,
#> #   gender <chr>, age <int>, vip <lgl>, vip_ep <lgl>, vip_cover_image <lgl>,
#> #   director <lgl>, user_slug <chr>, user_trakt <int>, avatar <chr>
lists_trending()
#> # A tibble: 10 × 32
#>    name      description privacy share_link type  display_numbers allow_comments
#>    <chr>     <chr>       <chr>   <chr>      <chr> <lgl>           <lgl>         
#>  1 MARVEL C… "**UPDATED… public  ""         pers… TRUE            TRUE          
#>  2 IMDB: To… "Top 250 m… public  ""         pers… TRUE            TRUE          
#>  3 IMDB: To… "Top 250 T… public  ""         pers… TRUE            TRUE          
#>  4 Best Min… "What’s a … public  ""         pers… FALSE           TRUE          
#>  5 1001 Gre… "/u/StopRe… public  ""         pers… TRUE            TRUE          
#>  6 Studio G… "Animated … public  ""         pers… TRUE            TRUE          
#>  7 Pixar Fe… "Feature f… public  ""         pers… TRUE            TRUE          
#>  8 Marvel C… ""          public  ""         pers… TRUE            FALSE         
#>  9 Highly r… "Shows wit… public  ""         pers… FALSE           TRUE          
#> 10 100 Anim… "Based on … public  ""         pers… FALSE           TRUE          
#> # ℹ 25 more variables: sort_by <chr>, sort_how <chr>, created_at <dttm>,
#> #   updated_at <dttm>, item_count <int>, comment_count <int>, likes <int>,
#> #   slug <chr>, trakt <chr>, username <chr>, private <lgl>, deleted <lgl>,
#> #   joined_at <dttm>, location <chr>, about <chr>, user_name <chr>,
#> #   gender <chr>, age <int>, vip <lgl>, vip_ep <lgl>, vip_cover_image <lgl>,
#> #   director <lgl>, user_slug <chr>, user_trakt <int>, avatar <chr>