You must be logged into an account to view the generated documentation for each endpoint.

Deprecation warning

All the GET endpoints of this API are now being replaced by the new Web of Science Researcher API.

Overview

The API is used to manage review information by partnered publishers. The current API version is v2. Responses are delivered as JSON or via this web interface.

Philosophy

This API is developed with YAGNI (You Aren't Going to Need It) in mind and supports the bare minimum needed by its current users.

Endpoints

Base url: /api/v2/.

Active

(POST) review/ - Allows integrated partners to POST reviews.

Deprecated

(GET) academic/ - List of (filterable) academics.
(GET) academic/[ID|ORCID|ResearcherID|TRUID]/ - Details of an academic.
(GET) academic/review/ - List of (filterable) reviews, configured for an academic.
(GET) academic/review/[ID]/ - Details of a particular review, configured for an academic.
(GET) academic/publication/?academic=[ID|ORCID|ResearcherID|TRUID] - List of (filterable) publications, optionally configurable for an academic
(GET) academic/publication/[ID]/ - Details of a particular publication
(GET) article/[ID]/ - Details of an article.

Objects

Details of objects returned by GETS can be found here.

Details of objects required and returned by POSTS can be found here.

Authentication

Anonymous

Rejected

Session

While browsing the API your Publons session will be used to automatically authenticate you.

Token

Any other requests should include a token in the Authorization HTTP header and prefixed with "Token".

Access

Default

Requests are throttled to 100 per day.

Filtering

The API supports common query parameters, each endpoint may support additional parameters

paginate_by - (Int - default: 10, max: 10) Paginate list results.
format - (json, api - default: json) Select the response type.

Response Codes

200 OK - Success.
201 Created - Success.

Successful requests will return response objects or, if multiple objects are found, paginated lists of objects.

400 Bad Request - You are doing something wrong.
403 Forbidden - You do not have permission to do this.
404 Not Found - Resource not found.
405 Method Not Allowed - You're probably trying to post to a resource that only supports GET.

Unsuccessful requests will return a dictionary of errors.

500 Internal Server Error.

Terms of Service

By using the Publons API you agree to the Publons API Terms of Service and the Clarivate Terms of Use.