Retrieve Issues of a Journal & Optional New Content Filtering

The “Retrieve Issues of a Journal” endpoint allows a client to retrieve the metadata for issues published for a given journal in the Third Iron metadata database. Optionally, the endpoint can fetch issues that contain new content over a specific date range.

Contact Third Iron Support to Request your API Key

Email us at support@thirdiron.com to request your API Key.  The Data Service API can only be used by institutions subscribing to the Third Iron Data 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 whose issues you are trying to retrieve, and your application will get a response representing that journal's issues. Responses contain:

  • some metadata about each issue, such as a display name for the issue

  • links to API endpoints through which metadata resources related to each issue, such as a list of the issue's articles

Retrieve Issues of a Journal Request

Supported Methods

GET

Endpoint Location

/public/v1/libraries/:library_id/journals/:journal_id/issues

Endpoint Parameters

 

:library_id

Required. Replace the :library_id portion of the endpoint path with the id # of your library

:journal_id

Required. Replace the journal_id portion of the path with the id number for the journal whose issues you wish to retrieve



new_content_start_date

Optional query string parameter. If present, new_content_end_date must also be present.

Format this value as YYYY-MM-DD.

When present, this will cause the endpoint to only include issues that have new content between new_content_start_date and new_content_end_date , inclusive of those two dates. The date range must be within the last 6 months.

This value must be earlier or equal to new_content_end_date.

For accurate results, this date should be no earlier than August 5, 2022.

new_content_end_date

Optional query string parameter. If present, new_content_start_date must also be present.

Format this value as YYYY-MM-DD.

When present, this will cause the endpoint to only include issues that have new content between  new_content_start_date and new_content_end_date , inclusive of those two dates. The date range must be within the last 6 months.

This value must be later or equal to new_content_start_date.

Retrieve Issues of a Journal Response

The Retrieve Issues of a Journal endpoint responds with a blob of JSON data that contains an array of issue resource objects that represent the issues of the journal with the specified id.

Response Object

Property

Type

Description

Property

Type

Description

data

Array of Object

An array of issue resource objects is returned here which represents the issues in the Third Iron metadata database of the journal which has the specified id.


Journal Resource

An issue resource object represents an issue 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 issue's unique id in the Browzine system

No

type

string

has the value “issues”

No

title

string

The issue’s title for display (typically “Vol. # Issue #”)

No

date

string

The publication date of the issue expressed in ISO date format (YYYY-MM-DD)

No

relationships

Object

An object representing relationships between the issue resource object and resource objects that represent other records in the Third Iron metadata database

Yes

relationships.journal

Object

An object representing the relationship between the issue resource object and the resource object that represents the issue's journal in the Third Iron Metadata database

Yes

relationships.journal.links

Object

An object holding links for the journal relationship

Yes

relationships.journal.links.related

URL

A URL path to the API endpoint that retrieves the resource object that represents the journal of the issue represented by the issue resource object.

Yes

relationships.articles

Object

An object representing the relationship between the issue resource object and the resource objects that represent the articles of the issue

Yes

relationships.articles.links

Object

An object holdings links for the articles relationship

Yes

relationships.articles.links.related

URL

A URL path to the API endpoint that retrieves the resource objects that represent the articles of the issue represented by the issue resource object

Yes


Examples

Retrieving issues of journal 35087 with new content between Aug 25, 2022, and Aug 31, 2022, for library 222

 

 

Notes

 

 

Notes

Request URL

https://public-api.thirdiron.com/public/v1/libraries/222/journals/35087/issues?new_content_start_date=2022-08-25&new_content_end_date=2022-08-31&access_token=abc123-abc123

Using a GET HTTP method

Response

{ "data": [ { "id": 217042388, "title": "Vol. 64", "date": "2019-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/217042388/articles" } } } }, { "id": 121212145, "title": "Vol. 63", "date": "2018-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/121212145/articles" } } } }, { "id": 8457802, "title": "Vol. 62", "date": "2017-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/8457802/articles" } } } }, { "id": 7707389, "title": "Vol. 61", "date": "2016-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/7707389/articles" } } } }, { "id": 7786133, "title": "Vol. 60", "date": "2015-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/7786133/articles" } } } }, { "id": 7070591, "title": "Vol. 59", "date": "2014-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/7070591/articles" } } } }, { "id": 6542551, "title": "Vol. 57 Issue 4", "date": "2012-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542551/articles" } } } }, { "id": 6542548, "title": "Vol. 57 Issue 3", "date": "2012-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542548/articles" } } } }, { "id": 6542547, "title": "Vol. 57 Issue 2", "date": "2012-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542547/articles" } } } }, { "id": 6542546, "title": "Vol. 57 Issue 1", "date": "2012-03-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542546/articles" } } } }, { "id": 6542545, "title": "Vol. 56 Issue 4", "date": "2011-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542545/articles" } } } }, { "id": 6542543, "title": "Vol. 56 Issue 3", "date": "2011-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542543/articles" } } } }, { "id": 6542534, "title": "Vol. 56 Issue 2", "date": "2011-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542534/articles" } } } }, { "id": 6542542, "title": "Vol. 56 Issue 1", "date": "2011-03-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542542/articles" } } } }, { "id": 6542541, "title": "Vol. 55 Issue 4", "date": "2010-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542541/articles" } } } }, { "id": 6542535, "title": "Vol. 55 Issue 3", "date": "2010-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542535/articles" } } } }, { "id": 6542533, "title": "Vol. 55 Issue 2", "date": "2010-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542533/articles" } } } }, { "id": 6542532, "title": "Vol. 55 Issue 1", "date": "2010-03-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542532/articles" } } } }, { "id": 6542531, "title": "Vol. 54 Issue 4", "date": "2009-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542531/articles" } } } }, { "id": 6542530, "title": "Vol. 54 Issue 3", "date": "2009-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542530/articles" } } } }, { "id": 6542529, "title": "Vol. 54 Issue 2", "date": "2009-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542529/articles" } } } }, { "id": 6542536, "title": "Vol. 54 Issue 1", "date": "2009-03-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542536/articles" } } } }, { "id": 6542540, "title": "Vol. 53 Issue 4", "date": "2008-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542540/articles" } } } }, { "id": 6542539, "title": "Vol. 53 Issue 3", "date": "2008-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542539/articles" } } } }, { "id": 6542538, "title": "Vol. 53 Issue 2", "date": "2008-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542538/articles" } } } }, { "id": 6542537, "title": "Vol. 53 Issue 1", "date": "2008-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542537/articles" } } } } ] }

This shows issues that had new content added to them from Aug 25, 2022, to Aug 31, 2022.

 

 

 

Retrieving issues of journal 35087 for library 222

 

 

Notes

 

 

Notes

Request URL

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

Using a GET HTTP method

Response

{ "data": [ { "id": 217042388, "title": "Vol. 64", "date": "2019-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/217042388/articles" } } } }, { "id": 121212145, "title": "Vol. 63", "date": "2018-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/121212145/articles" } } } }, { "id": 8457802, "title": "Vol. 62", "date": "2017-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/8457802/articles" } } } }, { "id": 7707389, "title": "Vol. 61", "date": "2016-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/7707389/articles" } } } }, { "id": 7786133, "title": "Vol. 60", "date": "2015-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/7786133/articles" } } } }, { "id": 7070591, "title": "Vol. 59", "date": "2014-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/7070591/articles" } } } }, { "id": 6542551, "title": "Vol. 57 Issue 4", "date": "2012-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542551/articles" } } } }, { "id": 6542548, "title": "Vol. 57 Issue 3", "date": "2012-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542548/articles" } } } }, { "id": 6542547, "title": "Vol. 57 Issue 2", "date": "2012-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542547/articles" } } } }, { "id": 6542546, "title": "Vol. 57 Issue 1", "date": "2012-03-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542546/articles" } } } }, { "id": 6542545, "title": "Vol. 56 Issue 4", "date": "2011-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542545/articles" } } } }, { "id": 6542543, "title": "Vol. 56 Issue 3", "date": "2011-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542543/articles" } } } }, { "id": 6542534, "title": "Vol. 56 Issue 2", "date": "2011-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542534/articles" } } } }, { "id": 6542542, "title": "Vol. 56 Issue 1", "date": "2011-03-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542542/articles" } } } }, { "id": 6542541, "title": "Vol. 55 Issue 4", "date": "2010-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542541/articles" } } } }, { "id": 6542535, "title": "Vol. 55 Issue 3", "date": "2010-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542535/articles" } } } }, { "id": 6542533, "title": "Vol. 55 Issue 2", "date": "2010-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542533/articles" } } } }, { "id": 6542532, "title": "Vol. 55 Issue 1", "date": "2010-03-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542532/articles" } } } }, { "id": 6542531, "title": "Vol. 54 Issue 4", "date": "2009-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542531/articles" } } } }, { "id": 6542530, "title": "Vol. 54 Issue 3", "date": "2009-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542530/articles" } } } }, { "id": 6542529, "title": "Vol. 54 Issue 2", "date": "2009-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542529/articles" } } } }, { "id": 6542536, "title": "Vol. 54 Issue 1", "date": "2009-03-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542536/articles" } } } }, { "id": 6542540, "title": "Vol. 53 Issue 4", "date": "2008-12-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542540/articles" } } } }, { "id": 6542539, "title": "Vol. 53 Issue 3", "date": "2008-09-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542539/articles" } } } }, { "id": 6542538, "title": "Vol. 53 Issue 2", "date": "2008-06-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542538/articles" } } } }, { "id": 6542537, "title": "Vol. 53 Issue 1", "date": "2008-01-01", "type": "issues", "relationships": { "journal": { "links": { "related": "/public/v1/libraries/222/journals/35087" } }, "articles": { "links": { "related": "/public/v1/libraries/222/issues/6542537/articles" } } } } ] }

The payload for this may be quite large, especially for journals published every week. It could include hundreds and hundreds of issues.