Please be sure to use api.springernature.com in your API calls. Use of api.springer.com is being deprecated.
Supported Query Parameters
Query Constraints
What fields are available for querying (e.g., DOI, ISSN, etc.)? Some constraints apply to specific APIs but not all. We represent this as follows:
- M: metadata API
- M2: meta/v2 API
- O: openaccess API
- F: Full Text API
| Constraint | Description | Applies to collection | Basic Plan* | Premium Plan* |
|---|---|---|---|---|
| doi:* | limit to a single Digital Object Identifier | M,O,M2,F |  | |
| doi:* | query multiple Digital Object Identifiers | M,O,M2,F | | |
| subject: | limit to the specified subject collection | M,O,M2,F | | |
| keyword: | limit to articles tagged with a keyword | M,O,M2,F | | |
| language: | limit to articles from a particular language | M,O,M2,F | | |
| pub: | limit to articles from a particular publication | M,O,M2,F | | |
| year: | limit to articles/chapters published in a particular year | M,O,M2,F | | |
| onlinedate: | limit to date that an article appeared online | M,O,M2,F | | |
| onlinedate(from/to): | limit to date range that an article appeared online, using onlinedatefrom, onlinedateto | M,O,M2,F | | |
| date(from/to): | limit to date range that an article was published, using datefrom, dateto (useful for older content where onlinedate might not exist) | M,O,M2,F | | |
| dateloaded: | limit to date that an article appeared in the database | M,O,M2,F | | |
| dateloaded(from/to): | limit to date range where loaded to database | M,O,M2,F | | |
| country: | limit to articles authored in a particular country | M,O,M2,F | | |
| isbn: | limit to a single International Standard Book Number | M,O,M2,F | | |
| issn: | limit to a single International Standard Serial Number | M,O,M2,F | | |
| journalid: | limit articles to a single Journal id | M,O,M2,F | | |
| topicalcollection: | limit content to a single toplical collection | M,M2,F | | |
| journalonlinefirst:true | limit articles to Online first | M,O,M2,F | | |
| date: | limit to documents published on a particular date {yyyy - mm - dd} | M,O,M2,F | | |
| issuetype | limit content to a issuetype | M,M2,F | | |
| issue | limit articles to a issue for journal | M,O,M2,F | | |
| volume | limit articles to a volume for journal | M,O,M2,F | | |
| type: | limit to either Book or Journal content {(Book, Journal)} | M,O,M2,F | | |
| ContainsElements: | limit to content containing a specific item | M,O,M2,F | | |
| excludeElements | [parameter] to exclude specific field from result | O,F | | |
| Exclude:Bibliography | do not search through bibliography/references; useful for finding terms that appear in the text only | M,O,M2,F | | |
| grid: | Global Research Identifier Database, providing unique identifiers for research organizations. | M,O,M2,F | | |
| orcid: | global identifier for specific author | M,O,M2,F | | |
| bookdoi: | limit to chapters from a specific BookDOI | M,O,M2,F | | |
| latest issue | limit to articles from the latest issue of the journal available in the database. | M,M2,F | | |
| earliest issue | limit to articles from the earliest issue of the journal available in the database. | M,M2,F | | |
| openaccess:true | limit to only Open Access content | M2,F | | |
| free:true | limit to only Free content (different from OA) | M,M2,F | |
"Contains" Constraints
When a "contains" constraint is applied, the response will return documents in which the specified argument appears anywhere within the relevant element.
The API currently supports the following types of "contains" constraints:
| Constraint | Description | Applies to collection | Basic Plan* | Premium Plan* |
|---|---|---|---|---|
| empty | A word or phrase that appears among the constraints but is not preceded by a constraint value will be treated as the argument of the "empty constraint" (i.e., a text/string search). Requests of this type will locate documents that contain the specified word or phrase in any element. | M,O,M2,F | | |
| title: | Locate documents containing a word or phrase in the "article/chapter title" element | M,O,M2,F | | |
| orgname: | Locate documents containing a word or phrase in the "organization name" element | M,O,M2,F | | |
| journal: | Locate documents containing a word or phrase in the "journal title" element | M,O,M2,F | | |
| book: | Locate documents containing a word or phrase in the "book title" element | M,O,M2,F | | |
| name: | Locate documents containing a word or phrase in the "author name" element | M,O,M2,F | |