Notice: Over the next few months, we're reorganizing the App Engine documentation site to make it easier to find content and better align with the rest of Google Cloud products. The same content will be available, but the navigation will now match the rest of the Cloud products. If you have feedback or questions as you navigate the site, click Send Feedback.

Python 2 is no longer supported by the community. We recommend that you migrate Python 2 apps to Python 3.

The SearchResults Class

Stay organized with collections Save and categorize content based on your preferences.

Class SearchResults represents the result of executing a search request using Index.search().

Caution: **This solution is no longer recommended:** Apps that use this API can only run in the Python 2 runtime and will need to upgrade to a [recommended solution](/appengine/docs/legacy/standard/python/migrate-to-python3/migrating-services#migration_paths_for_bundled_services) before migrating to the Python 3 runtime.

SearchResults is defined in the google.appengine.api.search module.

Constructor

The constructor for class SearchResults is defined as follows:

class SearchResults(number_found, results=None, cursor=None)

Request the search service to query an index, specifying parameters for that query..

Arguments

number_found

The number of documents found for the query.

results

The list of ScoredDocument objects returned from executing a search request.

cursor

A Cursor object allowing you to continue the search from the end of the current search results.

Result value

A new instance of class SearchRequest representing the results of executing Index.search().

Exceptions

TypeError

If any of the parameters have an invalid type, or an unknown attribute is passed.

ValueError

If any parameter has an invalid value.

Properties

An instance of class SearchResults has the following properties:

results

Returns the list of ScoredDocument objects matching the query.

number_found

Returns an approximate number of documents matching the query. QueryOptions defining post-processing of the search results. If the QueryOptions.number_found_accuracy parameter were set to 100, then number_found <= 100 is accurate.

cursor
For this field to be populated, you must pass a cursor in the search's QueryOptions, otherwise this will be None. Returns a results Cursor that can be used to continue the search from the last result. If there are no more results after the current result, returns None.