<?xml version="1.0" encoding="utf-8"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns="http://purl.org/rss/1.0/"
         xmlns:mn="http://usefulinc.com/rss/manifest/"
         xmlns:dc="http://purl.org/dc/elements/1.1/">

  <channel rdf:about="http://www.journaltocs.hw.ac.uk/api/">
    <title>JournalTOCs API</title>
    <link>http://www.journaltocs.ac.uk/develop.php</link>
    <description><![CDATA[This is the URL Base for the JournalTOCs API, which is freely available for developers to create their own web applications with Table of Contents (TOCs) published by over 16,000 scholarly journals.]]></description>
    <dc:publisher>JournalTOCs API</dc:publisher>
    <dc:creator>JOURNALTOCS API PROJECT</dc:creator>
		<dc:coverage>1</dc:coverage>
    <image rdf:resource="http://www.journaltocs.hw.ac.uk/images/xtralogo.gif" />
    <items>
      <rdf:Seq><rdf:li rdf:resource="http://www.journaltocs.ac.uk/api" />
      </rdf:Seq>
    </items>
  </channel>
    <item rdf:about="http://www.journaltocs.ac.uk/develop.php">
    <link>http://www.journaltocs.ac.uk/develop.php</link>
    <title>API Usage</title>
    <description><![CDATA[To use this API you need to specify what you want to extract from our database of TOC RSS feeds. You will provide that 
		information by indicating (1) the name of the "call" or resource-type you want to search and (2) a query string 
		<p>This is an example of using the API to search for all the journals that contain any word starting with <i>scient</i> in their titles:<br>
    http://www.journaltocs.ac.uk/api/journals/scient*?user=macleod.roddy@gmail.com
    <p>(in the example, the call is "journals", the query string is "scient*" and the username is macleod.roddy@gmail.com)</p>    
		<p>(1) These are the calls currently being supported by the API: (names need to be provided in lower case)
		<ul>
    <li> journals: to do a search in the journal titles (can return journal's metadata or the articles<br>
    <li>  articles: to search in the metadata found in the journal TOC articles<br>
    <li>  user: to extract the RSS feeds found in the mytocs folder of the user identified by the specified email address<br>
    <li>  institution: to search for latest articles published in journals subscribed by an institution.<!--<br>
    <li>  subjects: to search for journals using the DDC based subject classification available at journalTOCs<br>
    <li>  publishers: to fetch the journals available at journalTOCs for the specified publisher name.-->
    </ul>
    <p>(2) You are free to use any keywords in your query string. However, it is useful to notice that:
		<ul>
    <li>  <b>IMPORTANT:</b> If you are using "journals" you must specify your username.<br>
		If you don't have a username with JournalTOCs, please first sign up at <a href="http://www.journaltocs.ac.uk/index.php?action=register">http://www.journaltocs.ac.uk/index.php?action=register</a> before using the API call "journals"<br>
		<br>Your query string can be an ISSN value, a JournalTOCs unique ID or any keyword(s)<br>
		In fact you can create four types of searches with the "journals" call:<br>
		1. by ISSN number:<br>
example:<br>
http://www.journaltocs.ac.uk/api/journals/1533-290X?user=macleod.roddy@gmail.com<br>
2. by exact journal title (phrase):<br>
example:<br>
http://www.journaltocs.ac.uk/api/journals/"journal of medicinal chemistry"?user=macleod.roddy@gmail.com<br>
3. by keyword(s) included in anywhere in the title<br>
example:<br>
http://www.journaltocs.ac.uk/api/journals/journal+of+medicinal+chemistry?user=macleod.roddy@gmail.com<br>
4. By journal title that start exactly with a keyword or a phrase<br>
example:<br>
http://www.journaltocs.ac.uk/api/journals/"journal of medicinal?user=macleod.roddy@gmail.com <br>
To get the full RSS feeds for the journal, please use:<br>
http://www.journaltocs.ac.uk/api/journals/0002-7294?output=articles&user=macleod.roddy@gmail.com<br>
    <li>  If you are using "articles" your query string can be any keyword(s)<br>
		<li>  By default, the Boolean operator is "AND". Thus, for example<br> 
      http://www.journaltocs.ac.uk/api/articles/british geological survey<br>
      will only return items that contain the three keywords (british, geological and survey).<br>
    <li>  You can change the default Boolean operator by inserting ORs in your search query. For example:<br>
      http://www.journaltocs.ac.uk/api/articles/british or geological or survey<br>
      will return all the records that contain at least one of the words British, geological or survey<br>
		<li> To search phrases, please enclose your query string using double quotations. For example<br>
		  http://www.journaltocs.ac.uk/api/articles/"University%20of%20Warwick"

<li>  To get the journal TOCs of all journals that you have saved in your MyTOCs folder, enter your email address as the "resource-type" or call. 
You do not need to specify a query string in this case. For example:<br>
		  http://www.journaltocs.ac.uk/api/r.a.macleod@hw.ac.uk

<li>  To search for latest articles published in journals subscribed by your institution, enter your institution identification as the "resource-type" or call. 
You  need to specify a query string in this case. For example:<br>
		  http://www.journaltocs.ac.uk/api/HeriotWatt/corrosion<br>
			returns the journals subscribed by the Heriot Watt University that contain the query string "corrosion" in their RSS feed items.<br>
			(*) Currently, this call works only for the Heriot Watt University
    </ul>		
		
		<p>Each resource-type is associated with an specific API call.</p>
    <p>Currently the API return results in RSS 1.0 format only.</p>
    <p>Go to http://www.journaltocs.ac.uk/index.php?action=api for further information.</p>
		<p>Technical Documentation: <a href="http://www.journaltocs.ac.uk/api_help.php"><u><b>http://www.journaltocs.ac.uk/api_help.php</b></u></a></p>]]></description>
    </item>
	
  <rdf:Description rdf:ID="manifest">
    <mn:channels>
      <rdf:Seq>
        <rdf:li rdf:resource="http://www.journaltocs.hw.ac.uk/api/" />
      </rdf:Seq>
    </mn:channels>
  </rdf:Description>

</rdf:RDF>