Crossref Event Data

Early Preview: This service is under development

This service is under development with a launch expected the second half of 2016. You are welcome to take a look around pre-launch to get a feel for what data the service may offer when it’s released. Please note this service is not yet live. We will greatly expand the variety of platforms from which we will collect data. As this is a system in active development, you may experience hiccups in the service.

Please contact us at with any questions or suggestions as we continue to work on the development.

What Event Data will offer

Discussion around scholarly research often takes place on the web outside of the formal literature; for example on blogs, sharing services, social media, and wikis. This activity is made up of a number of individual “events” such as a bookmark, a comment, a social share, or a link.

What’s needed is community infrastructure to collect, store, and provide this raw data for anyone to access.

Crossref Event Data will capture and record a wide variety of events related to any content with a unique digital object identifier (DOI). The data will be openly available, portable, and auditable. Initially the service will not include scholarly citation events from citation index platforms.

Anyone, such as publishers, funders, authors, bibliometricians, and librarians, will be able to process, interpret and integrate Event Data as they wish, gaining a broad understanding of how scholarly content is shared and consumed.

What are 'Events' and how are they collected?

An event is any activity that occurs around a research object that has a DOI. Event types are varied depending on the source of the activity. Here are some event examples:

In this early preview, you can view the specific event types listed below for our first five initial sources:

Data source Collection method Refresh rate Data collected Event type
Crossref to DataCite Crossref Metadata API Crossref pushes Crossref - DataCite links into Event Data once per day Links to DataCite DOIs as cited in Crossref DOIs Every citation from a Crossref DOI to a DataCite DOI
DataCite to Crossref DataCite API DataCite pushes DataCite - Crossref links into DataCite Event Data once per day. Crossref then pulls these links into Event Data once per day. Links to Crossref DOIs as cited in DataCite DOIs Every citation from a DataCite DOI to a Crossref DOI
Wikipedia Full streaming data from Wikimedia Streaming (near real time) Edits to Wikipedia pages that mention a DOI directly, or edits that remove such a mention A 'references' event type for the reference from the Wikipedia page to the DOI. If the action field is 'delete' then this indicates that the reference was removed.
Mendeley Mendeley API Pulling data. Rate TBC, currently daily Counts of how many times a DOI has been bookmarked and liked The Mendeley Data Source provides the event type of bookmarks and likes. Each one has a date stamp and a count.
Twitter Full streaming data from Gnip Streaming (near real time) DOIs (or DOI domain URLs) mentioned in tweets Every tweet that mentions a DOI or article landing page that we can match to a DOI. The DOI is included in the event. If a landing page was used, this data will be available via the audit log.

Want to take a look?

We have an interim display of the raw data available at At launch in the second half of 2016, we will provide formal mechanisms to view and access this data.

Each publication in this system is displayed as a 'work.' Browse event data for the external platform of interest based on Source or Works. Within the Works tab, select an event. The event activity is then displayed in the Relations tab, while the Results tab displays a summary visualization based on the date in which the system received the data.

For example, has been bookmarked in Medeley and cited in Wikipedia. View the live data for this work here

Event Data screnshot

Background reading

You can find background on the Event Data section of the Crossref blog, including the planned list of sources, and updates on the development of the service.

Getting started

Don’t know where to turn? We suggest a read of our Quick Start guide to help get you, well, started!

User Guide

For more comprehensive technical documentation though, we have prepared a preliminary Crossref Event Data Technical User Guide with specifications to help provide you with an overview. Please note that specifications and documentation will continue to evolve as we progress through the technical development of this new service throughout 2016.

Please do get in touch if you have any questions or feedback as we continue to build the service.