Access and licensing
Commercial or research use of Search requires a separate license agreement, it isn’t covered by individual plans. Email sales before relying on Search for anything beyond evaluation.Basic search
term supports Boolean operators (AND, OR, NOT) and phrase search ("exact phrase").
Filtering results
Beyondterm, the search endpoint accepts filters across three categories:
- Publication metadata
- Citation signals
- Domain-specific
title, abstract, author / authors, journal / journals, publisher, paper_type / paper_types, affiliation / affiliations, topic / topics, date_from, date_to, doi / doisdoi (single) or dois (multiple). Combine with term to search within those publications only.
Sorting
Usesort to control result order:
Combine with
sort_order (asc/desc).
Pagination
Uselimit (up to 10,000 per request) and offset together to page through results.
Aggregations
Setcompute_aggregations=true and pass aggregations to get facet counts (e.g. by journal or year) alongside your results, useful for building filter UIs without a second round-trip.
Search snippets are always redacted on self-service (Pro plan) API keys. Full snippet access requires an Enterprise agreement. Contact sales.
Response shape
Results come back as{ count, countIsApproximate, aggregations, hits, suggestedTerm, restrictedCites }. Each item in hits is a full paper object, including a tally field with the same shape as the tallies endpoints when one has already been computed for that paper (null otherwise), so you often don’t need a separate tally call for search results you’re already displaying.
Get recommended papers
If you already have a DOI, retrieve related papers without constructing a search query:tally when available, and a recommendation score.
Related
- Full parameter reference: see Search in the API Reference tab for every filter with types and examples
- Recommendation endpoint reference: see Paper recommendations in the API Reference tab
- Citations & Tallies: what
has_tally,supporting_from, etc. actually measure - Errors and rate limits: distinguish invalid credentials from missing scopes
