To get started with the Newspapers API you need an API key, to know where the endpoint is located and to know its response formats. This page will help you get underway.
While the API is in a beta phase, you need to request a separate access key. When the API will be made public, you will be able to use your Europeana REST API key for authentication. You can request a key by sending a request to firstname.lastname@example.org.
Support and discussions
Join the Europeana API discussion group at Google Groups and get regular updates about the Europeana API, provide feedback and discuss it with other developers.
Every Newspapers API call is an HTTP request in a specified format that is sent to the Newspapers API service. The API root URLs for the service is at:
The Newspapers API supports the JSON and the XML formats. To control the response you can append the API method with one of the two. For JSON:
To authenticate your API client against the Newspapers API you need to pass along your API key as part of the wskey parameter:
An error during processing of an API method is reported by a relevant HTTP status code and a meaningful error message.
The following HTTP status codes are returned:
|HTTP Status Code||Description|
|200||The request was executed successfully.|
|401||Authentication credentials were missing or authentication failed.|
|404||The requested method was not found.|
|500||Internal Server Error. Something has gone wrong, which we will correct.|