Journal Lookup by Issue Availability

Although this endpoint continues to work, a newer endpoint with similar functionality, but improved results, is now available. Please see Data Service API Endpoints for links to the updated documentation.


The “Journal Lookup by Issue Availability” endpoint allows a client to retrieve journals in the Third Iron metadata database which have published issues within a specified date range.  It takes a start date and an end date as query parameters and returns an array of journal resource objects which represent the journals within the Third Iron metadata database which have issues published between those dates.  


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 adding to the query string a start date and an end date specified in ISO date format (YYYY-MM-DD).  Your application will receive a response representing the journals in the database which have issues published between those dates.  Responses contain some metadata for each journal, such as a display name and the journal's issn.  Responses also contain links to API endpoints through which metadata resources related to each journal, such as a list of its issues, may be retrieved.  

Journal Lookup by Issue Availability Request:

Supported Methods
GET
Endpoint Location
/public/v1/libraries/:library_id/journals/issue-lookup

Endpoint Parameters


:library_idReplace the :library_id portion of the endpoint path with the id # of your library
?start_date

add a query string parameter named start_date to specify the beginning of the date range the endpoint should check for issues.  The value should be expressed in YYYY-MM-DD format

?end_dateadd a query string parameter named end_date to specify the end of the date range the endpoint should check for issues.  The value should be expressed in YYYY-MM-DD format

Journal Lookup by Issue Availability Response:

The Journal Lookup by Issue Availability endpoint responds with a blob of JSON data that contains an array of journal resource objects that represent the journals in the Third Iron metadata data which have issues published within the specified date range.

Response Object:
PropertyTypeDescription
dataArray of Object

An array of journal resource objects is returned here which represents the journals in the Third Iron metadata database which have issues published within the specified date range.


Issue Resource:

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


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

Property
Type
Description
Optional
idnumber

The journal's unique id in the Browzine system

No
typestringhas the value "journals"No
titlestringThe journal's titleNo
issnstring

The issn for the journal that matches the issn passed in on the endpoint

(formatted with no hyphen)

The issn for print is used preferentially here unless the journal has only an e-issn in which case that is the value returned.


No
browzineEnabledbooleanTrue when the title is available within Browzine at the specified libraryNo
coverImageUrlstringA url to a small image that can be used to visually depict the journalNo
sjrValuenumberThe Scimago Journal Rank (SJR) - see all their ranking at their website

No

browzineWebLinkURLOn titles that are browzine enabled, this property will be present and will link to the journal's current issue within browzine.comYes
externalLinkURLOn 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 systemYes

Example Request, retrieving journals with issues published between 10/25/19 & 11/1/19:
GET https://public-api.thirdiron.com/public/v1/libraries/222/journals/issue-lookup?start_date=2019-10-25&end_date=2019-11-1

Example Response:
{
    "data": [
        {
            "id": 6062,
            "type": "journals",
            "title": "Desalination",
            "issn": "00119164",
            "sjrValue": 1.689,
            "coverImageUrl": "https://assets.thirdiron.com/images/covers/0011-9164.png",
            "browzineEnabled": true,
            "browzineWebLink": "https://develop.browzine.com/libraries/222/journals/6062?utm_source=api_714",
            "relationships": {
                "issues": {
                    "links": {
                        "related": "/public/v1/libraries/222/journals/6062/issues"
                    }
                },
                "current-issue": {
                    "links": {
                        "related": "/public/v1/libraries/222/journals/6062/issues/current"
                    }
                }
            }
        },
        {
            "id": 1269,
            "type": "journals",
            "title": "Journal of Membrane Science",
            "issn": "03767388",
            "sjrValue": 2.119,
            "coverImageUrl": "https://assets.thirdiron.com/images/covers/0376-7388.png",
            "browzineEnabled": true,
            "browzineWebLink": "https://develop.browzine.com/libraries/222/journals/1269?utm_source=api_714",
            "relationships": {
                "issues": {
                    "links": {
                        "related": "/public/v1/libraries/222/journals/1269/issues"
                    }
                },
                "current-issue": {
                    "links": {
                        "related": "/public/v1/libraries/222/journals/1269/issues/current"
                    }
                }
            }
        },
        {
            "id": 35039,
            "type": "journals",
            "title": "Int. Journal of Clinical Pharmacology and Therapeutics",
            "issn": "09461965",
            "sjrValue": 0.389,
            "coverImageUrl": "https://assets.thirdiron.com/images/covers/0946-1965.png",
            "browzineEnabled": false,
            "externalLink": "http://um9mh3ku7s.search.serialssolutions.com/?V=1.0&N=100&L=UM9MH3KU7S&S=I_M&C=0946-1965",
            "relationships": {
                "issues": {
                    "links": {
                        "related": "/public/v1/libraries/222/journals/35039/issues"
                    }
                },
                "current-issue": {
                    "links": {
                        "related": "/public/v1/libraries/222/journals/35039/issues/current"
                    }
                }
            }
        }
	]
}