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

Getting Started with the Python Search API

Amy Unruh, Oct 2012
Google Developer Relations

This class provides an introduction to the Python Search API for Google App Engine. This class and its follow-on will familiarize you with the basics of the features and capabilities of the Search API, so that you can implement full-text search in your App Engine applications.

The Search API lets your application perform Google-like full-text searches over structured data, and supports Geolocation-based queries. It can be useful in any application domain that benefits from full-text search, such as:

  • Product searches in an online store. The example application used in this course implements a simple version of such an application.
  • Location of nearby stores or events
  • User review search
  • Searching over blog posts and comments
  • Document discovery
  • Helpdesk answer retrieval
  • Résumé search and recruiting

The Search API provides a straightforward model for indexing and searching data and for displaying the results of the search. Search can query any data, so long as that data is described by a search document. You structure data in documents using fields to describe the different types of data the document contains, and then index the document.

After documents are indexed, you can search an index via the Search API's comprehensive] query language. When you query, you can specify sort orders on the results, control the presentation and content of search results, and use result cursors and offsets.


  • Learn the basics of using the App Engine Search API.


  • Python 2.7 and the Google App Engine SDK for Python

  • Some familiarity with Python

  • Know the basic structure of Python App Engine applications

  • Know how to run an application locally using the Development Web Server, and how to deploy an application on

Was this page helpful? Let us know how we did:

Send feedback about...

App Engine standard environment for Python 2