journalTOCs API Usage
Developers can use the JournalTOCs API (application programming interface) to embed our search functionality within their web applications to make the most of the journal TOC RSS feeds metadata. Anyone with access to RSS Readers can also use the JournalTOCs API.
The API gives you access to our entire database of articles, journals and publishers, which is being updated and continually collected from the publishers' own TOC RSS feeds, as soon as they are published on the web.
The search results will come in RSS format, which can then be parsed and used in your own environment, RSS reader or the search results could be included in your own web page.
Do you want to search for journal titles?
Answer: Use http://www.journaltocs.ac.uk/api/journals
Do you want to find articles matching a query string?
Answer: use http://www.journaltocs.ac.uk/api/articles
Do you want to have at hand an updated list of your favourite journal TOCs (myTOCs)?
Answer: use http://www.journaltocs.ac.uk/api/user/your@email.address
Do you want to have at tailored search results delivered to or embedded in your website?
Answer: use http://www.journaltocs.ac.uk/api/institution/yourServiceID
API Base URL:
http://www.journaltocs.ac.uk/api
The API supports four calls:
- http://www.journaltocs.ac.uk/api/journals
Use this call to get the TOC RSS feeds of a specific journal or to get all the journals whose titles match your query string. At the moment the results are returned in RSS 1.0 format only.
Examples:- http://www.journaltocs.ac.uk/api/journals/library gives a list of journals whose title contains the word library.
- http://www.journaltocs.ac.uk/api/journals/1533-290X?output=articles returns the latest TOC of the journal with ISSN 1533-290X.
- If you happen to know our internal unique identifier for a journal, you can use it. For example the journalTOCs ID for the Int. Journal of Technology Management (IJTM) is 6465. Therefore http://www.journaltocs.ac.uk/api/journals/6465?output=articles will return the latest TOC of IJTM.
Read the full Technical Documentation for "journals" call
- http://www.journaltocs.ac.uk/api/journals/library gives a list of journals whose title contains the word library.
- http://www.journaltocs.ac.uk/api/articles
Use this call to get all the articles from our database of TOC RSS feeds, whose metadata includes any keyword of your query string. The results are returned in RSS 1.0 format
Examples:- http://www.journaltocs.ac.uk/api/articles/corrosion gives a list of the latest articles containing the word corrosion.
- http://www.journaltocs.ac.uk/api/articles/"University of Warwick" returns a list of latest articles by authors
at "University of Warwick" (please notice the double quotes around University of Warwick for phrase searching).
- http://www.journaltocs.ac.uk/api/articles/dorothy+bishop returns a list of latest articles published by authors with the name Dorothy Bishop.
Read the full Technical Documentation for "articles" call
- http://www.journaltocs.ac.uk/api/articles/corrosion gives a list of the latest articles containing the word corrosion.
- http://www.journaltocs.ac.uk/api/user/your@email.address
Use this call to get the journal TOCs of all journals that you have saved in your MyTOCs folder. The results are returned in RSS 1.0 format
Examples:- http://www.journaltocs.ac.uk/api/user/macleod.roddy@gmail.com will return all the journals that a user with the email address of r.a.macleod@hw.ac.uk has saved in his MyTOCs folder. Please notice that the content stored in MyTOCs can be seen by any user that knows the email address of the MyTOCs owner.
- If you want to get the articles of MyTOCs journals you need to append ?output=articles to the user email address. Example:
http://www.journaltocs.ac.uk/api/user/l.j.rogers@hw.ac.uk?output=articles
Read the full Technical Documentation for "user" call
- http://www.journaltocs.ac.uk/api/institution/institutionID
Use this call to search the latest issues of journals for which your service or institution has subscriptions, and then link through to the full text, as everything found should be available to members of that Institution. The requirement is that the institution provides journalTOCs with an API to filter only the subscribed journals from the search results.
Example:- http://www.journaltocs.ac.uk/api/institution/HeriotWatt/corrosion%20steels
will return all the articles published in journals for which Heriot Watt University has subscriptions.
Example:- http://www.journaltocs.ac.uk/api/institution/TechXtra/corrosion%20steels
will return all the articles published in journals that are classified in the subject of TechXtra, in this case mainly technology and engineering.
Read the full Technical Documentation for "institution" call
- http://www.journaltocs.ac.uk/api/institution/HeriotWatt/corrosion%20steels
will return all the articles published in journals for which Heriot Watt University has subscriptions.
Notes:

journalTOCs API is licensed under a Creative Commons Attribution 2.0 UK: England & Wales License.


