Menu
Amazon CloudSearch
Developer Guide (API Version 2013-01-01)

Searching Your Data with Amazon CloudSearch

You specify the terms or values you want to search for with the q parameter. How you specify the search criteria depends on which query parser you use. Amazon CloudSearch supports four query parsers:

  • simple—search all text and text-array fields for the specified string. The simple query parser enables you to search for phrases, individual terms, and prefixes. You can designate terms as required or optional, or exclude matches that contain particular terms. To search particular fields, you can specify the fields you want to search with the q.options parameter. The simple query parser is used by default if the q.parser parameter is not specified.

  • structured—search specific fields, construct compound queries using Boolean operators, and use advanced features such as term boosting and proximity searching.

  • lucene—specify search criteria using the Apache Lucene query parser syntax. If you currently use the Lucene syntax, using the lucene query parser enables you to migrate your search services to an Amazon CloudSearch domain without having to completely rewrite your search queries in the Amazon CloudSearch structured search syntax.

  • dismax—specify search criteria using the simplified subset of the Apache Lucene query parser syntax defined by the DisMax query parser. If you are currently using the DisMax syntax, using the dismax query parser enables you to migrate your search services to an Amazon CloudSearch domain without having to completely rewrite your search queries in the Amazon CloudSearch structured search syntax.

You can use additional search parameters to control how search results are returned and include additional information such as facets, highlights, and suggestions with your search results.

For information about all of the Amazon CloudSearch search parameters, see the Search API Reference.