This web page contains the technical documentation to use the JournalTOCs API. The API is important for developers that need to embed or mashup the JournalTOCs API search functionality with any web applications to make the most of the journal TOC RSS feeds metadata and to provide enriched information for end-users.

The JournalTOCs API consists of 4 calls:

• journals
• articles
• user
• institution

journals

Performs searches either by keywords in the journal title, by ISSN or by JournalTOCs ID.
The default output is a list of journals matching the search criteria.
The output can be specified to the the latest articles from the journals matching the search criteria.

IMPORTANT: In order to be able to use "journals" you must specify your username.
If you don't have a username with JournalTOCs, please first sign up at
https://www.journaltocs.ac.uk/index.php?action=register
before using the API call "journals"

This is an example of using the API to search for all the journals that contain any word starting with scient in their titles:
 
https://www.journaltocs.ac.uk/api/journals/scient*?user=macleod.roddy@gmail.com

In the example, the call is "journals", the query string is "scient*" and the username is macleod.roddy@gmail.com

• Documentation
  • Base URL
  • Arguments
  • Example Query 1 (Search by Keywords in Journal Title)
  • Example Response 1
  • Example Query 2 (Search by ISSN of Journal)
  • Example Response 2
  • Example Query 3 (Serach by Exact Journal Title)
  • Example Response 3
  • Example Query 4 (Search by Journal Title that starts with Phrase)
  • Example Response 4
  • Example Query 5 (Search by JournalTOCs ID)
  • Example 5 Response
  • Example Query 6 (Query access rights of journal(s))
  • Example Query 7 (Retrieve the publisher name of journal(s))
  More information

articles

Performs searches by keywords in the article title, description and author elements.
The latest articles matching the search criteria are returned.

• Documentation
  • Base URL
  • Arguments
  • Authentication
  • Example Query 1 (Search by Exact Phrase)
  • Example Response 1
  • Example Query 2 (Search by Keywords)
  • Example Response 2
  • Example Query 3 (Institution Name)
  • Example Response 3
  • Example Query 4 (Author's Name)
  • Example Response 4
  • Example Query 5 (Wildcard *)
  • Example 5 Response
  • Example Query 6 (Search by DOI)
  • Example Response 6
  More information

user

Performs searches by email address of a registered user.
The default return is a list of journals that the user has added to MyTOCs.
If specified, the latest articles from the journals the user has added to MyTOCs are returned.

• Documentation
  • Base URL
  • Arguments
  • Example Query 1 (Search by Email Address for journal titles)
  • Example Response 1
  • Example Query 2 (Search by Email Address for latest articles)
  • Example Response 2
  More information

institution

Performs searches by keywords in the article title, description and author elements on a predefined subset.
The latest articles matching the search criteria are returned.

• Documentation
  • Base URL
  • Arguments
  • Authentication
  • Example Query 1 (HeriotWatt)
  • Example Response 1
  • Example Query 2 (TechXtra)
  • Example Response 2
  • Example Query 3 (ir_bgs)
  • Example Response 3
  More information