aggregateScholarlyWorks

Free

Run statistical aggregations over scholarly works matching a query or filters: publications per year, top authors, institutions, journals, publishers, funders, fields of study, countries, MeSH terms, open access and publication type breakdowns, and citation metrics including patent citations. Use for research landscape and science-to-patent impact analysis; pair with aggregatePatents for the patent side.

Try it

Open in playground
kirha tools run lens_aggregateScholarlyWorks \
  --input '{
    "aggregationType": "by_year"
  }'

Uses the key saved by kirha auth login.

  • aggregationTypestring, required

    One of by_year, top_authors, top_institutions, top_journals, top_publishers, top_funders, by_field_of_study, by_country, by_open_access, by_publication_type, by_mesh_term, by_year_and_open_access, by_year_and_publication_type, citation_metrics

  • aggregationSizenumber, default 10, 1 to 100

    Number of top buckets

  • authorstring

    e.g., Jennifer Doudna

  • citedByPatentsboolean
  • clinicalTrialIdstring

    e.g., NCT00105716

  • countrystring

    Author affiliation country, ISO alpha-2, e.g., US, FR

  • fieldOfStudystring

    e.g., Immunology, Machine learning

  • funderstring

    e.g., National Institutes of Health, European Research Council

  • institutionstring

    e.g., Harvard University

  • journalstring

    e.g., Nature Communications

  • meshTermstring

    Case-sensitive MeSH heading, e.g., Neoplasms

  • openAccessboolean
  • publicationTypestring

    One of journal_article, review, preprint, conference_proceedings_article, conference_proceedings, book, book_chapter, dissertation, dataset, report, letter, editorial, clinical_trial, clinical_study, working_paper, standard, other

  • publisherstring

    e.g., Elsevier

  • querystring

    Keywords searched in title, abstract and full text, e.g., CRISPR base editing

  • retractedboolean
  • rorIdstring

    Institution ROR ID, e.g., 01an7q238

  • yearFromnumber, 1800 to 2100
  • yearTonumber, 1800 to 2100