Note: Python 2.7 has reached end of support on January 31, 2024. Your existing Python 2.7 applications will continue to run and receive traffic. However, App Engine might block re-deployment of applications that use runtimes after their end of support date. We recommend that you migrate to the latest supported version of Python.

The SearchResults Class

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

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.

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.