CORE API

CORE harvests, maintains, enriches and makes available metadata and full-text content (typically a PDF) from many Open Access repositories. This makes it a useful access point for those who would like to develop applications making use of this content. To support these activities, CORE is providing a free API.

We have just released a new version of the CORE API, which is currently in beta. While the CORE API v2.0 is under development, we will keep the CORE API v1.0 running alongside the new version. However, the API v1.0 is deprecated and will eventually be replaced by the new version. We encourage everyone starting to use CORE to make use of the new API.

The documentation for the CORE API is available at:

Expected use

We expect the API can be used, for example, to:

  • Perform text mining to enrich metadata of Open Access publications or to even perform different kinds of semantic analysis of publications.

  • Semantically annotate (by means of crowdsourcing, collaborative sharing or natural language processing) the publications to drive the emergence of nano-publications in certain research fields.

  • Link publications to research data.

  • Carry out impact and citation analysis in the Open Access domain.

  • Many other services that need quick and easy access to the content of research publications...

API key registration

To register a new key to access the CORE API interface please use the form provided here.

Quota

The CORE API v2.0 allows to make a number of requests per time based on a usage courtesy quota. Each API method allows a different number of requests per time. The quotas for each of the methods are listed in the following tables:

Global methods

MethodRequest typeLimit
/searchbatch1 requests per 10 seconds
/search/{query}single2 requests per 5 seconds

Article methods

MethodRequest typeLimit
/articles/getbatch1 requests per 60 seconds
/articles/get/{coreId}single1 requests per 2 seconds
/articles/get/{coreId}/download/pdfsingle2 requests per 5 seconds
/articles/get/{coreId}/historysingle1 requests per 5 seconds
/articles/searchbatch1 requests per 120 seconds
/articles/search/{query}single1 requests per 30 seconds
/articles/similarsingle1 requests per 5 seconds

Journal methods

MethodRequest typeLimit
/journals/getbatch1 requests per 10 seconds
/journals/get/{issn}single1 requests per 1 seconds
/journals/searchbatch1 requests per 30 seconds
/journals/search/{query}single1 requests per 10 seconds

Repository methods

MethodRequest typeLimit
/repositories/getbatch1 requests per 10 seconds
/repositories/get/{repositoryId}single1 requests per 1 seconds
/repositories/searchbatch1 requests per 30 seconds
/repositories/search/{query}single1 requests per 10 seconds

In case you require lower limits please contact us.

CORE data as Linked Open Data (LOD)

Apart from the CORE API, CORE also provides data as LOD for enthusiasts. The documentation is available at the datahub. Please note the data are not synced regularly. We encourage all developers to use the CORE API v2.