Introduction

Searching is done by entering a query string into the search box. The query string can contain contain operators, fields, keywords, numeric intervals, date ranges, or free text search.

Text search

A free text search query without any operator, such as volvo for sale will match any documents that contains any of the words in any of the fields independently of their order. It is translated into a query of volvo OR for OR sale. If surrounding the query with double quotes, e.g. "volvo for sale" it will search for all of the words in that order.

It is also possible to specify words that must (+) and must not (-) be present. For example, apple +iPhone -7s finds any items where iPhone must be present, 7s must not be present and where apple is optional.

Search on specific fields

Besides, you can also specify what fields the query should match against. For example:

• To search for items that contain the word lamp in the title:
  document.content.title:lamp
• To search for items that contain any of the words iPhone 6s in the body:
  document.content.body:(iPhone 6s).
• To search for the exact phrase MacBook Pro in the body:
  document.content.body:"MacBook Pro".
• To search with a wildcard, add * to replace zero or more characters:
  document.content.category.name:Cars*.
• To search for a regular expression in the user name:
  document.user.name:/joh?n(ath[oa]n)/.

All the available fields are documented in the Available fields sections of this page.

Range search

For date, numeric and string fields, it is also possible to specify a range. Inclusive ranges are specified with square brackets [min TO max] and exclusive ranges with curly brackets {min TO max}. One sided ranges can be specified with >, >=, <, and <=. For example:

• To search for all items that were created in Implio from 2017-04-01 to 2017-04-07:
  metadata.created:[2017-04-01 TO 2017-04-07]
• To search for all items that have a price amount between 3 to 10:
  document.content.price.amount:[3 TO 10]
• To search for all items that have a price less than or equal to 50:
  document.content.price.amount:<=50

OR/AND Logical Operators

Finally, it is also possible to group multiple words, operators and clauses to form sub queries. For example,

• To search for all items where the title contains the word volvo, the price is less than 1000 and the result from Implio was APPROVE:
  document.content.title:volvo AND document.content.price.amount:<1000 AND metadata.result:APPROVE
• To search for all refused items that were reviewed by the agent John Doe:
  metadata.result:REFUSE AND metadata.manualResults.agentId:john.doe@besedo.com
• To search for all items that contain the words dangerous and phone in the body, the words volvo or sell in the title, where the category begins with Kl which were updated in Implio for the month of April:
  document.content.body:(dangerous AND phone) OR document.content.title:(volvo sell) AND document.content.category.name:Kl* AND metadata.updated:[2017-04-01 TO 2017-04-30]

Available search fields

Item related fields

These fields follow a similar structure as our API (https://besedo.com/api-documentation/#structure) except that the root level is represented by "document". Also note, that the fields below will return the data exactly as it was provided by the customer via the API. To query for edited body or title for instance, use the metadata fields in the next section

Metadata fields

Unlike the fields above that are provided by the customer, those documented below are generated automatically or manually in Implio.