The Metadata Plus service provides machine access to all our metadata records in both XML and JSON, with enhanced service and features.
For the first time, users may access multiple interfaces under one agreement, providing flexibility, robust functionality and improved support for the diverse and growing needs of the variety of organizations that use metadata in systems and services throughout scholarly communications. Enhancements include:
We are very excited to share our newest metadata service, called Plus, introduced in 2018. We invite you to explore below new features, including ‘snapshot’ full-file downloads,” our service commitment and more.
For subscribers, Plus provides options for query protocols and output formats, plus enhanced features and priority support.
For members, a more robust metadata delivery service supports improved content discoverability.
Why are two interfaces included? Do I have to use both?
Each interface has a different output format and uses a different protocol for retrieving records. Using both interfaces is optional, so if you’re already a subscriber, you don’t need to change what you are doing currently but you may want to take advantage of new features. We made this change so that organizations have the flexibility to choose which interface(s) to use, with access to all records in both XML and JSON, under one agreement.
How can I make sure I am getting the most from the Plus service?
Get in touch! We are happy to review the changes with you: Plus@crossref.org
This Service Description is applicable to the Agreement terms for the Crossref Metadata APIs Plus Service only.
The Metadata APIs Plus Service provides metadata records for all registered content items at Crossref in XML and/or JSON, with a service level agreement and additional features described below, which together comprise the Service.
Users may use either or both covered interfaces:
This API, for retrieving metadata in XML, uses the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) version 2 repository framework. It uses the interface as documented at http://www.openarchives.org/OAI/openarchivesprotocol.html.
This API, for searching and filtering metadata, is generally RESTFUL and returns results in JSON. It is documented at https://github.com/CrossRef/rest-api-doc.
Access is via Crossref-provided token, which may be used for OAI-PMH and/or the REST API.
Crossref will maintain an aggregated, average uptime for all of the interfaces that together comprise the Crossref Metadata Service of 99.5%, reported on a monthly basis. Crossref will provide technical support to Subscriber through Crossref’s existing support channels as requested by Subscriber, and will provide a response within one (1) business day to support requests received during normal working hours in the United States and the United Kingdom. “Business days” do not include weekends or legal holidays in the United States and the United Kingdom. “Response” means that support requests will be acknowledged. The time required for resolution will depend upon the nature of the request.
User-requested full-file downloads
Data may be requested in JSON and XML via an interface separate from each API.
Pre-generated reports available via machine request and human user interface.
Filters based on commonly used data are in under consideration:
Priority Service/Rate Limits
Plus users will be prioritized via isolated resources.
Minimum number of queries per second per IP address.
Rate limiting of the API is primarily on a per access token basis. If a method allows, for example, for 75 requests per rate limit window, then it allows 75 requests per window per access token. This number can depend on the system state and may need to change. If it does, Crossref will publish it in the response headers.
Please see our Fees page for pricing tiers and how we define revenue.
In 2018 we:
In 2019 our focus is on the ‘Sync’ feature (formerly known as Notifications):
This will allow people to update their records, for example, when citation counts change, without necessarily having to go and retrieve the entire record. More to come on this so please get in touch with Jennifer Kemp if you would like to be involved in testing or discussing any of the above, or have new things you’d like us to consider.
Each interface has extensive documentation available:
In the exceptional event that there is a release not backwards compatible, Crossref will provide extensive lead time to communicate the changes, as part of our proactive support for Plus users.
Please contact Jennifer Kemp if you would like to enquire about our Metadata APIs Plus Service.
Metadata Plus is an optional service on top of our public OAI-PMH and REST APIs that metadata users can actively request. For an annual fee, it gives you machine access to all our 111231936 metadata records in both XML and JSON formats with enhanced service and features. This service provides you with with access to all supported APIs and metadata, but with extra service and support guarantees that give you a consistent and predictable experience.
Metadata Plus snapshots provide access to our 111231936 metadata records in a single file, providing an easy way to retrieve an up-to-date copy of our records. Snapshots are available for Metadata Plus service users. The files are made available via a /snapshots route in the REST API which offers a compressed .tar file (tar.gz) containing the full extract of the metadata corpus in either JSON or XML formats. How to access snapshots New snapshots are created each month available by the 5th day, providing all records up to and including the previous month.
Background Crossref manages and maintains a database of digital identifiers assigned by Crossref (“Identifiers”) that are associated with specific items of professional and scholarly materials and content (collectively, “Content”). The database comprises metadata (collectively, “Metadata”) from Crossref members that describes, identifies and provides information (including bibliographic information, abstracts, and references) about—and points to the Internet location of—such Content. Metadata, including the Identifiers, are made available to subscribers of Crossref through Crossref’s service known as “Metadata Plus,” referred to in this Agreement as the “Service.