Installation

You can install the stable CRAN version

Or the development version:

remotes::install_github("ropensci/jaod")

Searching journals

To search for a journal you can use the jaod_journal_search, which provides information abut the search result, query and relevant information. For instance looking for heritage:

bibliography <- jaod_journal_search(query = "bibjson.keywords:heritage")
bibliography$results
#> # A tibble: 10 x 45
#>    id    created_date last_updated bibjson.alterna… bibjson.boai bibjson.eissn
#>    <chr> <chr>        <chr>        <chr>            <lgl>        <chr>        
#>  1 0223… 2017-06-30T… 2020-02-03T… Sampurasun Inte… TRUE         2460-5743    
#>  2 0363… 2020-07-03T… 2020-07-03T… <NA>             TRUE         1980-4466    
#>  3 041b… 2020-05-28T… 2020-05-28T… <NA>             TRUE         2618-5555    
#>  4 08d5… 2010-12-21T… 2020-02-03T… Ge conservación  TRUE         <NA>         
#>  5 0943… 2020-08-12T… 2020-08-19T… Revista de Cien… TRUE         2550-6722    
#>  6 097b… 2018-02-09T… 2020-02-03T… <NA>             TRUE         1982-095X    
#>  7 1005… 2018-07-23T… 2020-02-03T… Revista Turismo… TRUE         2313-853X    
#>  8 1642… 2012-07-13T… 2020-02-03T… <NA>             TRUE         1630-7305    
#>  9 1891… 2018-10-30T… 2020-08-13T… Zone Moda Journ… TRUE         2611-0563    
#> 10 1924… 2020-04-14T… 2020-04-14T… Herança: Revist… TRUE         2184-3090    
#> # … with 39 more variables: bibjson.pissn <chr>,
#> #   bibjson.publication_time_weeks <int>, bibjson.title <chr>,
#> #   bibjson.keywords <list>, bibjson.language <list>, bibjson.license <list>,
#> #   bibjson.subject <list>, bibjson.apc.has_apc <lgl>, bibjson.apc.url <chr>,
#> #   bibjson.article.license_display <list>,
#> #   bibjson.article.license_display_example_url <chr>,
#> #   bibjson.copyright.author_retains <lgl>, bibjson.copyright.url <chr>,
#> #   bibjson.deposit_policy.has_policy <lgl>,
#> #   bibjson.deposit_policy.service <list>, bibjson.editorial.review_url <chr>,
#> #   bibjson.editorial.board_url <chr>, bibjson.editorial.review_process <list>,
#> #   bibjson.other_charges.has_other_charges <lgl>,
#> #   bibjson.other_charges.url <chr>, bibjson.pid_scheme.has_pid_scheme <lgl>,
#> #   bibjson.pid_scheme.scheme <list>, bibjson.plagiarism.detection <lgl>,
#> #   bibjson.plagiarism.url <chr>, bibjson.preservation.has_preservation <lgl>,
#> #   bibjson.preservation.url <chr>, bibjson.preservation.service <list>,
#> #   bibjson.preservation.national_library <list>, bibjson.publisher.name <chr>,
#> #   bibjson.publisher.country <chr>, bibjson.ref.oa_statement <chr>,
#> #   bibjson.ref.journal <chr>, bibjson.ref.aims_scope <chr>,
#> #   bibjson.ref.author_instructions <chr>, bibjson.ref.license_terms <chr>,
#> #   bibjson.waiver.has_waiver <lgl>, bibjson.institution.name <chr>,
#> #   admin.seal <lgl>, admin.ticked <lgl>

We can see with bibliography$total the total amount of results with bibliography$total. On the bibliography$results we have the information about each entry, title, creation, update, title, subject. We have for instance the id of the journal in bibliography$results$id

Getting detailed information about a journal.

Once we have a journal we might be interested in more information. We can retrieve who administrate it, when was last updated, other bibliographic references:

journal <- jaod_journal(id = bibliography$result$id[1])

So for intance looking at the subject journal$bibjson$subject we can see that is based on Ethnology, social and cultural antrophology. Or that author doesn’t keep the publishing rights (journal$bibjson$author_publishing_rights$publishing_rights)

Searching articles

We might be looking for an article with some licensing

articles <- jaod_article_search(query = "license:CC-BY", sort = "bibjson.year:desc")
articles$results
#> # A tibble: 10 x 20
#>    last_updated created_date id    bibjson.identif… bibjson.end_page
#>    <chr>        <chr>        <chr> <list>           <chr>           
#>  1 2020-11-24T… 2013-03-07T… 3845… <df[,2] [1 × 2]> 5               
#>  2 2020-11-24T… 2013-02-28T… bbd2… <df[,2] [1 × 2]> 13              
#>  3 2020-11-24T… 2013-03-14T… a9db… <df[,2] [1 × 2]> 13              
#>  4 2020-11-24T… 2013-02-28T… 54c9… <df[,2] [1 × 2]> 8               
#>  5 2020-11-25T… 2013-02-28T… 3a06… <df[,2] [1 × 2]> 12              
#>  6 2020-11-25T… 2013-02-28T… ffe4… <df[,2] [1 × 2]> 8               
#>  7 2020-11-25T… 2013-02-28T… 6778… <df[,2] [1 × 2]> 12              
#>  8 2020-11-24T… 2013-02-28T… 02a9… <df[,2] [1 × 2]> 11              
#>  9 2020-11-24T… 2013-02-28T… 7294… <df[,2] [1 × 2]> 12              
#> 10 2020-11-25T… 2013-03-18T… a3d6… <df[,2] [1 × 2]> <NA>            
#> # … with 15 more variables: bibjson.year <chr>, bibjson.start_page <chr>,
#> #   bibjson.subject <list>, bibjson.author <list>, bibjson.link <list>,
#> #   bibjson.title <chr>, bibjson.keywords <list>, bibjson.abstract <chr>,
#> #   bibjson.journal.volume <chr>, bibjson.journal.country <chr>,
#> #   bibjson.journal.license <list>, bibjson.journal.issns <list>,
#> #   bibjson.journal.publisher <chr>, bibjson.journal.language <list>,
#> #   bibjson.journal.title <chr>

So we learn that there are

articles$total
#> [1] 5391806

with CC-BY license.

Or to know the dois, or other identifiers:

articles$results$bibjson.identifier[[1]]
#>          id  type
#> 1 1518-7039 pissn

Searching more detailed information about an article

If you are interested in information about the article you can use the id:

article <- jaod_article(articles$results$id[1])

We can access the title, authors, and more.

SessionInfo

sessionInfo()
#> R version 4.0.2 (2020-06-22)
#> Platform: x86_64-pc-linux-gnu (64-bit)
#> Running under: Ubuntu 20.04.1 LTS
#> 
#> Matrix products: default
#> BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/liblapack.so.3
#> 
#> locale:
#>  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
#>  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8    
#>  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
#>  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
#>  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
#> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
#> 
#> attached base packages:
#> [1] stats     graphics  grDevices utils     datasets  methods   base     
#> 
#> other attached packages:
#> [1] jaod_0.3.0
#> 
#> loaded via a namespace (and not attached):
#>  [1] Rcpp_1.0.5        knitr_1.30        magrittr_2.0.1    R6_2.5.0         
#>  [5] ragg_0.4.0        rlang_0.4.9       fansi_0.4.1       stringr_1.4.0    
#>  [9] tools_4.0.2       xfun_0.19         utf8_1.1.4        cli_2.2.0        
#> [13] ellipsis_0.3.1    htmltools_0.5.0   systemfonts_0.3.2 yaml_2.2.1       
#> [17] assertthat_0.2.1  rprojroot_2.0.2   digest_0.6.27     lifecycle_0.2.0  
#> [21] tibble_3.0.4      httpcode_0.3.0    pkgdown_1.6.1     crayon_1.3.4     
#> [25] textshaping_0.2.1 vctrs_0.3.5       fs_1.5.0          triebeard_0.3.0  
#> [29] curl_4.3          crul_1.0.1.91     glue_1.4.2        memoise_1.1.0    
#> [33] evaluate_0.14     rmarkdown_2.5     stringi_1.5.3     pillar_1.4.7     
#> [37] compiler_4.0.2    desc_1.2.0        urltools_1.7.3    jsonlite_1.7.1   
#> [41] pkgconfig_2.0.3