MedQuery 2.0.11

MedQuery

The MedQuery library is a wrapper around the PubMed APIs for EFetch and ESearch. It allows for querying and retrieving publication data from PubMed.

Features

• Query PubMed for journal article and book publication data
• Query constructor for author, title, affiliation, and date-based searches
• Parse PubMed TXT article data files
• Parse PubMed XML article data files

Installation

To install MedQuery, you can use the following command:

dotnet add package MedQuery --version [latest version number]

Usage

// Create search criteria
SearchTerms searchTerms = new SearchTerms()
  .DateTerm(THIS_YEAR)
  .AuthorTerm("John Doe")
  .AuthorTerm("Jane Doe")
  .AffiliateTerm("University of Learning");

// Instantiate an EUtilsAPI with the search terms
EUtils api = new EUtilsAPI(searchTerms);

// Run your search
if (await api.GetResultsAsync())
{
  // Handle results in the here...
  foreach (var article in api.SearchResults.Articles)
  {
    // Do work... //
  }
}

Limitations

We tested and thoroughly reviewed the ESearch/EFetch documentation to ensure that all search result data is captured, but this API may still miss some data types. An 'errorTracking' argument has been provided in the 'GetResultsAsync' method to allow users to detect if data types were missed when generating search results. When activated, this may slow down the response time for searches.

Over time, we hope to add additional publication types and databases to this API.

Updates

• Added book results.
• Moved the search result data into the 'SearchResult' property of the 'EUtilAPI'.
• Fixed bugs that prevented some publication data stored in outer XML fields from populating.
• Added an error reporting option to searches designed to detect data fields not handled by this API.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please direct any contribution requests to the repository owner.

Contact

For any questions or issues, please open an issue on this repository or contact the repository owner directly.