- What is the PLOS Search API?
- What is Solr?
- How does the PLOS Search use Solr?
- Are there any examples using the PLOS Search API?
- Recommended Usage of the PLOS Search API
- How do I request a PLOS API key?
- How do I use the PLOS API key?
- I have questions about using the PLOS Search API. Where can I get answers?
What is the PLOS Search API?
The entire PLOS corpus of research articles is regularly indexed in Apache Solr. PLOS provides programmatic access to the Solr API via the http://api.plos.org/search endpoint. Documentation for Solr Queries can be found here. The PLOS endpoint uses “search” instead of the “select” used in the Solr documentation and requires an api key to identify api users.
What is “Solr”?
Solr is an open-source search platform from the Apache Lucene project. Essentially, Lucene is a Java-based indexing and search tool. Solr provides a friendly way to query Lucene and format the results. PLOS uses Solr version 4.1.0.
How does the PLOS Search use Solr?
Are there any example using the PLOS Search API?
Sure are! We have a number of examples here:
And there are more examples using the PLOS Search API.
Recommended Usage of the PLOS Search API
- Content Attribution: Developers are welcome to make use of the data returned from the PLOS Search API and we ask that you indicate that the data originate from PLOS. If you wish to brand your work to PLOS, you will need to ask us to evaluate the usefulness and technical capability of your application prior to receiving a PLOS logo which you may then display on the application. Please see the API display policy for more information.
- PLOS Search API rate limit: Please limit your API requests to 7200 requests a day, 300 per hour, 10 per minute and allow 5 seconds for your search to return results. If you exceed this threshold, we will lock out your IP address. If you’re a high-volume user of the PLOS Search API and need more API requests a day, please contact us at email@example.com to discuss your options. We currently limit API users to no more than five concurrent connections from a single IP address.
- PLOS Search API requests: Please do not send requests that return more than 100 rows. That’s a lot of data for our network to push all at once and it may take some time to return the result set. If you are getting back a result set that bigger than 100+ rows, then you likely need to change your query to return a smaller result set or set a limit on the records returned and page through the results.
How do I request a PLOS API key?
How do I use the PLOS API key?
Any request made to the PLOS API must include the argument api_key=[your PLOS API key]. That’s it!