search_papers: Searching for papers by keyword

View source: R/semantic_scholar.R

search_papersR Documentation

Searching for papers by keyword

Description

This function retrieves Semantic Scholar https://www.semanticscholar.org data for a keyword search.

Usage

search_papers(keyword, offset = 0, limit = 100, fields = NULL)

Arguments

keyword

string A plain-text search query string. No special query syntax is supported.Supports AND and OR and inclusion and exclusion of terms, for example "title=bibliometrics" or "+Epidemic+Modeling+Canada-COVID".See blog post https://medium.com/ai2-blog/building-a-better-search-engine-for-semantic-scholar-ea23a0b661e7 for a description of our search relevance algorithm.

offset

integer Default: 0. When returning a list of results, start with the element at this position in the list.

limit

integer Default: 100. The maximum number of results to return. The sum of offset and limit must be < 10000.

fields

string A comma-separated list of the fields to be returned, support one or more fileds, for example fileds = get_fields()[['paper_search']] was all fields to be returned. See Format or see get_fields to set more params

Format

The following case-sensitive paper fields are recognized:

  • paperId : S2 generated research paper ID (Always included).

  • externalIds : Other catalog IDs for this paper, if known. Supports ArXiv, MAG, ACL, PubMed, Medline, PubMedCentral, DBLP, DOI.

  • title : Research paper title (Included if no fields are specified).

  • url : URL on the Semantic Scholar website.

  • abstract : Extracted abstract of the paper.

  • venue : Extracted publication venue for this paper.

  • year : Year this paper was published as integer.

  • referenceCount : The number of reference for this paper.

  • citationCount : The number of citation for this paper.

  • influentialCitationCount : The number of influential citation for this paper.

  • isOpenAccess : https://www.openaccess.nl/en/what-is-open-access

  • fieldsOfStudy : A list of high-level academic categories.

  • authors : Author(s) for this paper (Up to 500 will be returned).

    • authorId : Always included

    • name : Always included

Details

You can use the Semantic Scholar API endpoint up to 100 requests per 5 minutes to test your application idea. To access a higher rate limit, complete the form https://www.semanticscholar.org/product/api#Partner-Form to request authentication for your project. Current API users may have noticed that some paper requests would error out if the paper data was too large. The new service avoids this problem by, first, allowing you to specify exactly the data you’re interested in and, second, allowing you to paginate through large result sets, such as papers with many citations.

Value

list representing paper objects

Author(s)

Liuyong Ding

Examples

## Not run: 
res <- search_papers(keyword = "bibliometrics",fields = c("title","abstract","authors"))

## End(Not run)

Otoliths/S2miner documentation built on Dec. 5, 2023, 2:17 p.m.