RefWorks REST Interface
Overview PubMed Class nativesearch Method
nativesearch Method
Implements a search that lets the caller pass a native PubMed using PubMed's search field tags and query language.  

The results are sorted in the order they are received from PubMed.  Note: The "sort" query string parameter is ignored for PubMed search.

Once a search is conducted, recalling the same search to get the next page of results returns cached results and does not require a new search on PubMed.

<baseurl>/?class=pubmed&method=nativesearch&search=search="1"[Entrez Date] : "2009/03/01"[Entrez Date]&pgnum=1&pgsize=25<signature related and sess parameters>
Parameters
class
Set to pubmed.
method
Set to nativesearch.
search
PubMed query.  For instance search="1"[Entrez Date] : "2009/03/01"[Entrez Date] searches for records between a specific date.
max
(Optional) The maximum number of records to retrieve from PubMed.  This number can be bigger than "pgsize".  Default is 50.
pgnum
Indicates which page of references to return.  First page is 1.
pgsize
Indicates how many references are on a page.  Passing a value of 0 results in no references being returned.
sort
(Optional; Not used in Z39.50 class methods) Indicates how to sort the references returned.   Defaults differ depending on method called.  Supported values are:
ValueField
0Authors, Primary
1Pub Year, descending
2Pub Year, ascending
3Ref ID
4Ref Type
5Title, Primary
6Periodical, Full
7Periodical, Abbreviated
8Creation Date Time, descending
9Last Modified Date Time, descending
10(Used only for a Retrieve::quick method)  Relevancy
11(Used only for a Retrieve::dup method)  Duplicate
12Last Modified Date Time, ascending
style
(Optional) Indicates the output style used to format the references.   Default is 0 which is the RefWorks XML format (unformatted).   NOTE:  There can be more than one style parameter passed to allow for getting multiple styles.
ValueDescription
<Output style ID>ID of desired output style.  See the OutputStyle class for IDs.
0RefWorks XML format (unformatted).
-1Reference IDs in XML format.
-2RefWorks XML format with a modified <lv> element.   This modified <lv> element contains <item> elements with the vendor information.  For example,
   <lv>
      <item vendor="PUBMED" id="PMID" value="16249332" />
      <item vendor="PUBMED" id="PMCID" value="PMC1276082" />
   </lv>
language
(Optional and only used if the "style" parameter passed is an output style ID) Default is en for English.  Set to the first value in the HTTP_ACCEPT_LANGUAGE return by the browser or set to a value from Properties::languages method.
format
(Optional) Indicates the file type to format the references.  Default is html.
ValueDescription
htmlHTML
textUTF-8 text
biblist
(Optional; Used only if an output style ID is specified in the style parameter)   If true, all references are returned as a bibliography list in the output style specified.   If false, each reference is separated into its own <reference> element in the output style specified.  Default is false.
HTTP Verbs
GET
Performs the search and returns results.
HTTP Return Status Codes
Status CodeDescription
200Success.
400Bad request
401Unauthorized request
404No references found.
Methods
advancesearch Method | nativesearch Method | quick Method
See Also
Overview | Attachments Class | Authentication Class | Authors,Descriptors,Periodicals,Folders Class | Batch Class | Deleted Class | ImportFilter Class | Manuscript Class | MyList Class | OutputStyle Class | Properties Class | PubMed Class | Reference Class | Retrieve Class | RSS Class | SavedSearch Class | ShareProperties Class | Subscriber Class | SubscriberPrefs Class | User Class | Utility Class | Z39 Class
Modifications
Tue Jul 13 2010      Added "language" parameter.
Tue Sep 22 2009      Added "biblist" parameter and allow multiple "style" parameters.
Thu Apr 2 2009      Added.retrieve
View All API Modifications


C O N F I D E N T I A L