Introducing
CrossRef
Prospect
Cambridge, MA
2013
Geoffrey Bilder
Director of Strategic Initiatives
Taking the tedium out of TDM….

Geoffrey Bilder
Director of Strategic Initiatives
Text & Data
Mining
Gold
Diamond

Text & Data

?
The Problem
Institute * Channel View Publications, Ltd * Chartered Institution Of
Building Service Engineers * Chattagram Maa-O-Shishu Hospital
Medical College * Chelonian Conservation And Biology Journal *
Chelonian Research Foundation * Chem-Bio Informatics Society *
Chemical Engineering Diponegoro University * Chemical Science
Transactions * Chemical Society Of Japan * Chiang Mai University *
Children, Youth And Environments Center * Chimera Innova Group
* China Agricultural University * China Communications Magazine,
Co., Ltd. * China Journal Of Chinese Materia Medica * China
Petroleum Industry Press * China Science Publishing & Media Ltd. *
Chinese Astronomical Society * Chinese Birds * Chinese Birds (Press)
* Chinese Civilisation Centre * Chinese Geoscience Union * Chinese
Institute Of Automation Engineers (Ciae) * Chinese Journal Of
Mechanical Engineering * Chinese Mathematical Society * Chinese
Physical Society * Chinese Physiological Society * Chinese Society
Of Theoretical And Applied Mechanics * Chonnam National
University Medical School (Kamje) * Christ University Bangalore *
• All parties would benefit from support of standard APIs
and data representations in order to enable TDM across
both open access and subscription-based publishers.

• Subscription-based publishers find it impractical to
negotiate multiple bilateral agreements with thousands
of researchers and institutions in order to authorize TDM
of subscribed content.

• Researchers find it impractical to negotiate multiple
bilateral agreements with hundreds of subscriptionbased publishers in order to authorize TDM of subscribed
content.
Common API
DOI
Content
Negotiation
http://dx.doi.org/10.5555-12345678
(Accept: text/html)
http://dx.doi.org/10.5555-12345678
(Accept: application/bibjson+json)
New Metadata
Full Text Link
License Information
Rate Limiting
(Optional)
Prospect HTTP
Headers
CR-Prospect-Rate-Limit: 1500!

(the rate limit ceiling per window on Prospect
requests)
!

CR-Prospect-Rate-Limit-Remaining:

1387!

(number of requests left for the current window)
!

CR-Prospect-Rate-Limit-Reset: 1378072800!

(the remaining time in UTC epoch seconds before the
rate limit resets and a new window is started)
*this is a technique used by many APIs, including Twitter’s
Common API Summary
•

Content Negotiation (Required)

•

New Metadata (Required)
•
•

•

Full text URIs
License URIs

Rate Limiting Headers (optional)
Stop here if
•

You are an open access publisher

•

You include TDM as a part of your
subscription license/T&Cs.
Click-Through
License
Service
(Optional)
Research queries DOI using CN + API token
Publisher verifies API token with Prospect
(frequency at publisher discretion)

If token verified AND access control allows,	

publisher returns full text
Research queries DOI
using CN + API token
curl -H "Accept: text/turtle" "http://
dx.doi.org/10.5555/515151" -D - -L !
Link: <http://data.crossref.org/full-text/10.5555/515151>;
rel="http://id.crossref.org/schema/full-text";
anchor="http://annalsofpsychoceramics.labs.crossref.org/
fulltext/515151/515151.pdf"
Publisher verifies API
token with Prospect
curl -H "CR-Prospect-Publisher-Token:
MdvA59fGn8ukykYlSxJL6g" "https://
prospect.crossref.org/licenses/
hZqJDbcbKSSRgRG_PJxSBA" -D - -L!
{	

"result": "ok",	

"message": "licenses",	

"orcid": "0000-0002-1825-0097",	

"given_names": "Josiah",	

"family_name": "Carberry",	

"licenses": [	

{	

"uri": "http://www.crossref.org/tdm_license",	

"status": "rejected",	

"reviewed_at": "2013-05-28T17:09:36+00:00"	

},	

{	

"uri": "http://www.oxygenxml.com/",	

"status": "read",	

"reviewed_at": "2013-05-29T12:08:59+00:00"	

}	

]	

}
Sustainability
Model
•

New initiatives are always optional to our members. Members who do not
participate in our new initiatives will not be charged for them.

•

We do not charge end-users (e.g. researchers, librarians) for access to metadata
and APIs

•

We sometimes charge intermediaries for access to our services (to cover the cost
of administration, maintaining SLAs, etc.)

•

We do not charge our members for depositing extra metadata into our services

•

We sometimes charge our members for the cost of administering our services,
maintaining SLAs, development, etc.

•

We eschew charging mechanisms that involve complex administrative overhead.
The cost of developing and running them generally negates the revenue raised
by implementing them.

•

We try to tie any charges as directly as possible to where costs are incurred.
Current State
Prospect Working Group
•

AAAS: Walter Jones, Stewart Wills, Deborah Rivera-Wienhold

•

American Institute of Physics: Evan Owens,

•

American Physical Society: Mark Doyle

•

Elsevier: Chris Shillum, Ale de Vries

•

HighWire: John Sack, Craig Jurney

•

Institute of Physics Publishing: Graham McCann, James Walker

•

Springer: Chinchu Ann Belarmin, Michiel van der Heyden

•

Taylor & Francis: Gillian Howcroft

•

Walter de Gruyter: Bettina de Keijzer

•

Wiley: Edward Wates, Alan Bacon

•

CrossRef: Geoffrey Bilder, Chuck Koscher, Ed Pentz, Carol Meyer, Kirsty Meddings.
CrossRef
• DOI Content Negotiation	

• CrossRef support for recording links to full text 	

• CrossRef metadata Search for Discovery	

• CrossRef metadata support for license URIs	

• Click-through TDM license registry	

• Prospect publisher API for verifying, managing

Exists
Exists
Exists
Exists
Exists
Exists

tokens	


•Sample publisher code	

•Sample researcher code

Exists
Exists

✻ being extended to support mime-types
We are using CrossRef's Prospect text mining API in the context
of the Hiberlink project, which investigates reference rot in
scholarly papers at a very large scale. The API is really
straightforward and based on common technical approaches; it
can easily be integrated in a broader workflow. In our case, we
have a work bench that monitors newly published papers,
obtains their XML version via the API, extracts all HTTP URIs, and
then crawls and archives the referenced content. Currently, we
can only access Elsevier papers via the API but as more
publishers join Prospect, it will become a powerful, uniform onestop-shop for text mining scholarly literature.
--Martin Klein and Herbert Van de Sompel, Los Alamos National
Laboratory
I think this is a big step in the right direction and makes
retrieving full text file a lot easier, I hope that publishers support
it.
--Maximilian Haeussler, UCSD
What do I
need to do?
Publishers (required)

•

Register full-text URLs with CrossRef

•

Register <lic_ref> well-known license URIs with
CrossRef
Publishers (optional)

•

Register click-through proprietary licenses with
Prospect click-through service

•

Adapt platform APIs to handle Prospect API tokens
Researchers
•

Register with Prospect and accept/decline licenses

•

Modify TDM tools to look for <lic_ref> elements

•

Modify TDM tools to make use of Prospect API token
kmeddings@crossref.org

gbilder@crossref.org
Thank You
gbilder@crossref.org

2013 CrossRef Workshops Text Data Mining Geoffrey Bilder

  • 3.
  • 4.
    Taking the tediumout of TDM…. Geoffrey Bilder Director of Strategic Initiatives
  • 6.
  • 7.
  • 9.
  • 10.
    Institute * ChannelView Publications, Ltd * Chartered Institution Of Building Service Engineers * Chattagram Maa-O-Shishu Hospital Medical College * Chelonian Conservation And Biology Journal * Chelonian Research Foundation * Chem-Bio Informatics Society * Chemical Engineering Diponegoro University * Chemical Science Transactions * Chemical Society Of Japan * Chiang Mai University * Children, Youth And Environments Center * Chimera Innova Group * China Agricultural University * China Communications Magazine, Co., Ltd. * China Journal Of Chinese Materia Medica * China Petroleum Industry Press * China Science Publishing & Media Ltd. * Chinese Astronomical Society * Chinese Birds * Chinese Birds (Press) * Chinese Civilisation Centre * Chinese Geoscience Union * Chinese Institute Of Automation Engineers (Ciae) * Chinese Journal Of Mechanical Engineering * Chinese Mathematical Society * Chinese Physical Society * Chinese Physiological Society * Chinese Society Of Theoretical And Applied Mechanics * Chonnam National University Medical School (Kamje) * Christ University Bangalore *
  • 12.
    • All partieswould benefit from support of standard APIs and data representations in order to enable TDM across both open access and subscription-based publishers. • Subscription-based publishers find it impractical to negotiate multiple bilateral agreements with thousands of researchers and institutions in order to authorize TDM of subscribed content. • Researchers find it impractical to negotiate multiple bilateral agreements with hundreds of subscriptionbased publishers in order to authorize TDM of subscribed content.
  • 13.
  • 14.
  • 15.
  • 16.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
    Prospect HTTP Headers CR-Prospect-Rate-Limit: 1500! (therate limit ceiling per window on Prospect requests) ! CR-Prospect-Rate-Limit-Remaining: 1387! (number of requests left for the current window) ! CR-Prospect-Rate-Limit-Reset: 1378072800! (the remaining time in UTC epoch seconds before the rate limit resets and a new window is started) *this is a technique used by many APIs, including Twitter’s
  • 24.
    Common API Summary • ContentNegotiation (Required) • New Metadata (Required) • • • Full text URIs License URIs Rate Limiting Headers (optional)
  • 25.
    Stop here if • Youare an open access publisher • You include TDM as a part of your subscription license/T&Cs.
  • 26.
  • 34.
    Research queries DOIusing CN + API token Publisher verifies API token with Prospect (frequency at publisher discretion) If token verified AND access control allows, publisher returns full text
  • 35.
    Research queries DOI usingCN + API token curl -H "Accept: text/turtle" "http:// dx.doi.org/10.5555/515151" -D - -L !
  • 36.
  • 37.
    Publisher verifies API tokenwith Prospect curl -H "CR-Prospect-Publisher-Token: MdvA59fGn8ukykYlSxJL6g" "https:// prospect.crossref.org/licenses/ hZqJDbcbKSSRgRG_PJxSBA" -D - -L!
  • 38.
    { "result": "ok", "message": "licenses", "orcid":"0000-0002-1825-0097", "given_names": "Josiah", "family_name": "Carberry", "licenses": [ { "uri": "http://www.crossref.org/tdm_license", "status": "rejected", "reviewed_at": "2013-05-28T17:09:36+00:00" }, { "uri": "http://www.oxygenxml.com/", "status": "read", "reviewed_at": "2013-05-29T12:08:59+00:00" } ] }
  • 42.
  • 43.
    • New initiatives arealways optional to our members. Members who do not participate in our new initiatives will not be charged for them. • We do not charge end-users (e.g. researchers, librarians) for access to metadata and APIs • We sometimes charge intermediaries for access to our services (to cover the cost of administration, maintaining SLAs, etc.) • We do not charge our members for depositing extra metadata into our services • We sometimes charge our members for the cost of administering our services, maintaining SLAs, development, etc. • We eschew charging mechanisms that involve complex administrative overhead. The cost of developing and running them generally negates the revenue raised by implementing them. • We try to tie any charges as directly as possible to where costs are incurred.
  • 44.
  • 45.
    Prospect Working Group • AAAS:Walter Jones, Stewart Wills, Deborah Rivera-Wienhold • American Institute of Physics: Evan Owens, • American Physical Society: Mark Doyle • Elsevier: Chris Shillum, Ale de Vries • HighWire: John Sack, Craig Jurney • Institute of Physics Publishing: Graham McCann, James Walker • Springer: Chinchu Ann Belarmin, Michiel van der Heyden • Taylor & Francis: Gillian Howcroft • Walter de Gruyter: Bettina de Keijzer • Wiley: Edward Wates, Alan Bacon • CrossRef: Geoffrey Bilder, Chuck Koscher, Ed Pentz, Carol Meyer, Kirsty Meddings.
  • 47.
    CrossRef • DOI ContentNegotiation • CrossRef support for recording links to full text • CrossRef metadata Search for Discovery • CrossRef metadata support for license URIs • Click-through TDM license registry • Prospect publisher API for verifying, managing Exists Exists Exists Exists Exists Exists tokens •Sample publisher code •Sample researcher code Exists Exists ✻ being extended to support mime-types
  • 48.
    We are usingCrossRef's Prospect text mining API in the context of the Hiberlink project, which investigates reference rot in scholarly papers at a very large scale. The API is really straightforward and based on common technical approaches; it can easily be integrated in a broader workflow. In our case, we have a work bench that monitors newly published papers, obtains their XML version via the API, extracts all HTTP URIs, and then crawls and archives the referenced content. Currently, we can only access Elsevier papers via the API but as more publishers join Prospect, it will become a powerful, uniform onestop-shop for text mining scholarly literature. --Martin Klein and Herbert Van de Sompel, Los Alamos National Laboratory
  • 49.
    I think thisis a big step in the right direction and makes retrieving full text file a lot easier, I hope that publishers support it. --Maximilian Haeussler, UCSD
  • 50.
  • 51.
    Publishers (required) • Register full-textURLs with CrossRef • Register <lic_ref> well-known license URIs with CrossRef
  • 52.
    Publishers (optional) • Register click-throughproprietary licenses with Prospect click-through service • Adapt platform APIs to handle Prospect API tokens
  • 53.
    Researchers • Register with Prospectand accept/decline licenses • Modify TDM tools to look for <lic_ref> elements • Modify TDM tools to make use of Prospect API token
  • 55.
  • 56.