adsfolio.api.journals

Journals API wrapper for ADS.

Provides access to journal metadata: - Summary information by bibstem - Journal name search - Holdings and reference sources - ISSN lookup

class adsfolio.api.journals.JournalsAPI(client)[source]

Bases: object

Journals API for querying journal metadata.

Examples

>>> api = JournalsAPI(client)
>>> summary = api.summary("ApJ")
>>> print(summary["master"]["journal_name"])
Parameters:

client (BaseClient)

browse(bibstem)[source]

Get abbreviated summary for a journal.

Parameters:

bibstem (str) – Journal bibstem.

Returns:

Abbreviated journal summary.

Return type:

dict

holdings(bibstem, volume)[source]

Get available electronic sources for a journal/volume.

Parameters:

  • bibstem (str) – Journal bibstem.

  • volume (str) – Volume number.

Returns:

Holdings data with available sources.

Return type:

dict

issn(issn_number)[source]

Look up bibstem by ISSN.

Parameters:

issn_number (str) – ISSN identifier (with or without hyphens).

Returns:

Matching bibstem, or None if not found.

Return type:

str or None

refsource(bibstem)[source]

Get citation data sources by volume for a journal.

Parameters:

bibstem (str) – Journal bibstem.

Returns:

Reference source data per volume.

Return type:

dict

search(query)[source]

Search for journals by name or abbreviation.

Parameters:

query (str) – Search text to match against journal names.

Returns:

List of matching journal records.

Return type:

list[dict]

summary(bibstem)[source]

Get summary information for a journal by bibstem.

Parameters:

bibstem (str) – Journal bibstem (case-sensitive), e.g., “ApJ”, “MNRAS”.

Returns:

Journal summary including master record, identifiers, abbreviations.

Return type:

dict