CINXE.COM
ERIC FAQ - Searching ERIC with the API
<!DOCTYPE html> <html> <head> <script async src="https://www.googletagmanager.com/gtag/js?id=G-Q61Y5YWXL4"></script><script>window.dataLayer=window.dataLayer || [];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','G-Q61Y5YWXL4');</script><title>ERIC FAQ - Searching ERIC with the API</title><meta name="description" content="ERIC is an online library of education research and information, sponsored by the Institute of Education Sciences (IES) of the U.S. Department of Education."><meta name="citation_abstract" content="ERIC is an online library of education research and information, sponsored by the Institute of Education Sciences (IES) of the U.S. Department of Education."><link rel="shortcut icon" href="favicon.ico" type="image/x-icon" /><link rel="stylesheet" href="css/eric.css?v=0.9" media="all"><link rel="image_src" href="img/icon_fbshare.png"><script type="text/javascript" src="js/jquery-3.5.1.min.js"></script><script type="text/javascript" src="js/respond.min.js"></script><script type="text/javascript" src="js/eric.js?v=0.8"></script> <script type="text/javascript">$(function() {});</script> </head> <body id="bdyMain"> <div id="main"> <div id="actionbar"><a href="?note">Notes</a><a href="?faq">FAQ</a><a href="?contact">Contact Us</a></div><div id="logo"><a href="?" id="aHome" title="ERIC Home"><img src="img/eric_results.png" id="imgLogo" alt="ERIC - Institute of Education Sciences" /></a></div> <div id="sbar"> <form id="f"> <div> <div id="tab1" class="sTab"><span>Collection</span></div> <div id="tab1b" class="sTab"><a href="#thesaurus">Thesaurus</a></div> <a id="atips" href="?advanced">Advanced<br />Search Tips</a> <input id="s" type="text" name="q" placeholder="Search education resources" /> <input type="submit" value="Search" /> </div> <div id="sopt"> <label><input type="checkbox" name="pr" /> Peer reviewed only</label> <label><input type="checkbox" name="ft" /> Full text available on ERIC</label> </div> </form> <form id="ft" style="display:none"> <div> <div id="tab2b" class="sTab"><a href="#collection">Collection</a></div> <div id="tab2" class="sTab"><span>Thesaurus</span></div> <a id="attips" href="?ti=all">Browse<br />Thesaurus</a> <input id="st" type="text" name="qt" placeholder="Search thesaurus descriptors" /> <input type="submit" value="Search" /> </div> <div id="soptt"> <label><input type="checkbox" name="ts" /> Include Synonyms</label> <label><input type="checkbox" name="td" /> Include Dead terms</label> </div> </form> </div> <div id="r"> <div id="rf"></div> <div id="rr"> <div id="rrw"></div> <div id="rrm"></div> </div> </div> <div id="i"> <div id="details"> <div id="nmleft" style="width:220px"> <div id="nmleft_h" class="FAQNav"> <div><a href="/?faq">FAQ Home</a><ul><li><a href="/?faq-general">General</a></li><li><a href="/?faq-content">ERIC Content</a></li><li><a href="/?faq-fulltext">Full Text</a></li><li><a href="/?faq-peerreview">Peer Review</a></li><li><a href="/?faq-searching">Searching ERIC</a></li><li>Searching ERIC with the API</li><li><a href="/?faq-thesaurus">Thesaurus and Identifiers</a></li><li><a href="/?faq-requirements">Awardee and Contractor Requirements</a></li><li><a href="/?faq-submission">Online Submission for Non-awardees</a></li><li><a href="/?faq-records">Changing or Removing Records</a></li></ul></div> </div> </div> <div id="nmmain" style="padding-left:246px"> <div> <div><a class="toggleClear">Open All</a><div class="nmt">Searching ERIC with the API</div><!-- searching_api --> <div class="toggleBlock"> <h3>What can I do with the ERIC API?</h3> <p>ERIC implemented an Application Programming Interface (API) to help researchers, developers, and third-party providers gain flexible access to ERIC metadata. You can search the ERIC collection and export the metadata to a variety of programs for display and analysis or download to a database. The API provides a range of options for using ERIC’s freely available metadata. Access the ERIC API <a href="https://eric.ed.gov/?api">here</a>. For information on the many uses of the API, access our recorded webinar:</p> <iframe width="444" height="250" src="https://www.youtube.com/embed/SCIxFmJWgD4?rel=0" frameborder="0" allow="autoplay; encrypted-media"></iframe> <p>For a short overview of the ERIC API, access the following video:</p> <iframe width="444" height="250" src="https://www.youtube.com/embed/lwdOXjIbpLw?rel=0" frameborder="0" allow="autoplay; encrypted-media"></iframe> <p>For guidance on using the API to export search results, access this video:</p> <iframe width="444" height="250" src="https://www.youtube.com/embed/4iVbsld7WRA?rel=0" frameborder="0" allow="autoplay; encrypted-media"></iframe> </div> <div class="toggleBlock"> <h3>Are there any tips for searching with the API?</h3> <p>Yes, there are four things to keep in mind when putting a search string together:</p> <ul> <li>The default between search terms in the API is OR, not AND as in the ERIC website. Therefore, you do need to insert AND when you want to combine search terms. </li> <li>You do not need to add a <b style="font-size: 1.25rem;">*</b> to search terms to retrieve variations of the search word鈥攖he API automatically stems terms. For example, if you search the word“read” the API will also pick up the words“reads,” “readers,” and“reading.”</li> <li>You must use straight quote marks (for example: "word") and not smart or curly quote marks (for example: “word”).</li> <li>Some of the field names in the API differ from the field names used in ERIC website searches; for example, the API uses the term <em>subject</em> while the website uses the term <em>descriptor</em>. There is a table of field names on the API landing page.</li> </ul> </div> <div class="toggleBlock"> <h3>I haven't worked with an API before, is there a quick way for me to begin searching with the ERIC one?</h3> <p>Yes, here is a short video that shows step-by-step directions for conducting a search using the ERIC API:</p> <iframe width="444" height="250" src="https://www.youtube.com/embed/pnXnZG3msuo?rel=0" frameborder="0" allow="autoplay; encrypted-media"></iframe> </div> <div class="toggleBlock"> <h3>How do I export more than 2K records from an ERIC API search?</h3> <p>This video shows you how to save all the records from your API search, no matter how many results are returned:</p> <iframe width="444" height="250" src="https://www.youtube.com/embed/bTZ0v7bkGs0?rel=0" frameborder="0" allow="autoplay; encrypted-media"></iframe> </div> </div> </div> </div> </div> </div> <div id="divFooter"><div id="ftrPadding"><div id="ftr"><div id="ftrSocial"> <a href="http://www.facebook.com/SearchEduResources" id="facebook" style="padding-bottom:5px"><img src="img/icon_facebook.gif" alt="Facebook" width="16" height="16" border="0"></a> <a href="http://www.twitter.com/ERICinfo" id="twitter"><img src="img/icon_twitter.gif" alt="Twitter" width="16" height="16" border="0"></a></div><div id="ftrLogos"><a href="http://www.ed.gov"><img src="img/logo_ed.gif" alt="Department of Education"></a><a href="http://ies.ed.gov"><img src="img/logo_ies.gif" alt="Institute of Education Statistics"></a></div><div id="centerLinks"><a href="?privacy">Privacy</a> | <a href="?copyright">Copyright</a> | <a href="?contact">Contact Us</a> | <a href="?selection">Selection Policy</a> | <a href="?api">API</a> | <a href="metrics">Metrics</a><div><a href="?journals">Journals</a> | <a href="?nonjournals">Non-Journals</a> | <a href="?download">Download</a> | <a href="submit">Submit</a> | <a href="?multimedia">Multimedia</a> | <a href="?widget">Widget</a></div></div></div><script id="_fed_an_ua_tag" language="javascript" type="text/javascript" src="/js/Universal-Federated-Analytics-Min.js?pga4=55622235&agency=ED&subagency=ERIC"></script></div></div> </div> <script type="text/javascript">//<![CDATA[ if(self!=top) {top.location=self.location;} //]]></script> </body> </html>