How does the search functionality work on OnePetro?

The search engine within OnePetro can be found at the top of each OnePetro page.  OnePetro is now using the Solr search engine.  Solr is an enterprise search platform from the Apache Lucene project and one of the most popular enterprise search engines available.  The search syntax used within OnePetro is Solr's edismax which is much like Google's search syntax.

The results page always includes the search performed, how many results it returned and how long it took in milliseconds.

 Feature Syntax Example

Boolean Operators

This OR that
This AND that
This NOT that

Must Include, Must Not Include and Optional

This that
+This +that
This -that

Phrase Search

"This that"

Specifying Fields Title

"This that"
author:(Smith OR Jones)


(this AND that) OR (that AND other)

Users can select one of the following to sort their search results by:

  • Relevance
  • Most recent
  • Highest rated (by rating 1.0 – 5.0,including at least two significant digits.)  
    Note: Documents without a rating will be sorted as if having a rating of 0.

By default, results will be sorted by relevance.  Relevance takes into account

the following fields and weightings:


Phrase Weighting

Individual Term

Document Title






Keywords, Categories and Disciplines



PDF Full-Text



Phrase weighting means wherever a document's fields matches the user's search terms, in the exact order they entered them, that part of the scoring will be boosted by the amount in the table.

Individual term weighting applies when terms are matched but not necessarily in the same order the user entered them. For individual terms, by default we do not apply strict boolean operators (OR/AND), rather we have a 'minimum match'.

For searches with one or two terms, both terms MUST match.  For searches with more than three terms, 25% of the terms are optional. Searches matching more than 75% of the terms will still rank higher.

By selecting 'Most recent' users will be able to sort their results by publication date, newest first 

By selecting 'Highest rated' users will be able to sort their results by the technical rating of the documents.

Users will be able to select between 25, 50 and 100 results per page, with 25 results as a default.

How do I do a basic search?

Basic search provides an easy way to perform powerful searches within OnePetro.  The single search field searches the entire OnePetro database for the keyword(s) or phrase(s) entered.

To perform a basic search

Enter search terms in the search field found at the top of every OnePetro webpage.   By clicking the peer-reviewed box, search results will only bring up items that have been peer reviewed.  Users can also search by range of years, if needed.    To search an individual year, just type in the year in both range fields.   

How do I do an advanced search?

You can further define your basic search by clicking on Advanced Search.  Choices include Full Text, Author, Company/Institution, Publisher/Journal and Conference.

Once the results have been listed below the initial search, users can filter their results in varying ways including by Publication Date, Journal or Conference, Publisher and/or Type of Content Item.  

How do I save my OnePetro searches?

To easily repeat OnePetro searches you have created, just click on the Save Search button that follows the search results data.  This will save your search parameters and allow you to get back to the search for future reference.  

How do I request to Receive Email Alerts when NEW Content is Added?

To receive an email update when a new item has been added to OnePetro, you will need to save your search and then just choose Saved Searches in your My OnePetro.  Then, click on the box next to Email Alerts.  You will receive an email alert (to the email address you use within OnePetro) when new content is added that falls within the criteria you set in your saved search.

 ⇐Return to Help