Lookup Journal by Id

The lookup journal by id endpoint allows a client to retrieve the metadata for a specific journal provided they know the id number assigned to the journal within the Third Iron metadata database.

Contact BrowZine Support to Request your API Key

Email us at support@thirdiron.com to request your API Key. The BrowZine API can only be used by institutions subscribing to the BrowZine Service.

Submit a GET request against this endpoint, filling in the appropriate path segments with the id number of your library and with the id number of the journal that you are trying to retrieve, and your application will get a response representing the journal. Responses contain some metadata about the journal, such as a display name for the journal and publication date. Responses also contain links to API endpoints through which metadata resources related to the journal, such as the current issue of the journal or a list of all issues of the journal, may be retrieved.

Lookup Journal by Id Request

Supported Methods	`GET`
Endpoint Location	`/public/v1/libraries/:library_id/journals/:journal_id`
Endpoint Parameters
:library_id	Replace the :library_id portion of the endpoint path with the id # of your library
:journal_id	Replace the journal_id portion of the path with the id number for the journal

Lookup Journal by Id Response

The Lookup Journal by Id endpoint responds with a blob of JSON data that contains a journal resource object that represents the journal with the specified id.

Response Object

Property	Type	Description

Property	Type	Description
data	Object	A journal resource object is returned here which represents the journal in the Third Iron metadata database which has the specified id.

Journal Resource

A journal resource object represents a journal in the Third Iron metadata database.

The full list of properties that may appear on an issue resource object are described in detail in the table below:

Property	Type	Description	Optional

Property	Type	Description	Optional
id	number	The journal's unique id in the Browzine system	No
type	string	has the value "journals"	No
title	string	The journal's title	No
issn	string	The issn for the journal, formatted with no hyphen	No
browzineEnabled	boolean	True when the title is available within Browzine at the specified library	No
coverImageUrl	string	A url to a small image that can be used to visually depict the journal	No
sjrValue	number	The Scimago Journal Rank (SJR) - see all their ranking at their website	No
browzineWebLink	URL	On titles that are browzine enabled, this property will be present and will link to the journal's current issue within browzine.com	Yes
externalLink	URL	On titles that are not BrowZine enabled, this property may be present. When it is, it is a link to the journal within the library's A-Z system	Yes

Examples

Example Request, retrieving journal 35087 for library 222

GET https://public-api.thirdiron.com/public/v1/libraries/222/journals/35087

Example Response

{
    "data": {
        "id": 35087,
        "type": "journals",
        "title": "Acta Palaeontologica Polonica",
        "issn": "05677920",
        "sjrValue": 0.764,
        "coverImageUrl": "https://assets.thirdiron.com/images/covers/0567-7920.png",
        "browzineEnabled": true,
        "browzineWebLink": "https://develop.browzine.com/libraries/222/journals/35087?utm_source=api_714",
        "relationships": {
            "issues": {
                "links": {
                    "related": "/public/v1/libraries/222/journals/35087/issues"
                }
            },
            "current-issue": {
                "links": {
                    "related": "/public/v1/libraries/222/journals/35087/issues/current"
                }
            }
        }
    }
}

Third Iron Technical Documentation