Search API

What does it do?

This module provides a framework for easily creating searches on any entity known to Drupal, using any kind of search engine. For site administrators, it is a great alternative to other search solutions, since it already incorporates facetting support and the ability to use the Views module for displaying search results, filters, etc. Also, with the Apache Solr integration, a high-performance search engine is available for this module.

Developers, on the other hand, will be impressed by the large flexibility and numerous ways of extension the module provides. Hence, the growing number of additional contrib modules, providing additional functionality or helping users customize some aspects of the search process.

Examples & Demo

The prime example of a site using this module is drupal.org itself – the Search API, along with the database backend and Views, is used to generate the issue queue listings.

Note on security

In general, the Search API doesn't provide any kind of access restrictions (as this cannot be done on a generic level). It is therefore your responsibility to take care that only accessible items are indexed or results displayed (e.g., by using appropriate filters).
There is, however, built-in support for node access checks via the Node access data alteration (q.v. for details). Also, the Search views module contains an option to do additional access checks on all entities in search views.

Additional modules

At the moment, this project contains, apart from the core API module, the following extension module (in the version for Drupal 8+):

Database search

This module provides a ready-to-use search backend that indexes and searches content using Drupal's own database. It is mainly meant for testing purposes and for smaller sites, larger sites will usually want to use a more powerful backend (like Solr or Elasticsearch). Also provided is the "Database Search Defaults" module which provides a complete pre-configured content search when installed.

Tutorials and screencasts

The Getting started documentation page and the external material available (screencasts, etc.) might provide a good introduction to the module.

Other available backends and extensions

Please see the list of Search API Ecosystem modules and curated list of Extension modules. If you maintain or encounter a great Search API module, feel free to add it.

Requirements

To use the Views integration, you'll (of course) also need the Views module. For facets, you'll need the Facets module.
Furthermore, you'll need to enable at least one module that provides a search backend.

Information for developers

Extensive documentation for other developers, who might want to extend the framework's capabilities themselves, is available. It is partly included in the module itself (in search_api.api.php, in README.txt and directly in the relevant classes and interfaces) and partly in the online documentation (linked in the sidebar).
If you are trying to implement some extension and are stuck, please don't hesitate to ask in the module's issue queue. Please also add your module to the list of extension modules once it's finished, if it is generally useful.

All developers working in the Search API ecosystem are advised to keep an eye on #1188562: [meta] Important project announcements and the module's change records for important updates. (Could also contain useful information for site builders.)
Also, you can find us in the #search channel on Slack.

Sponsors

If you are interested in sponsoring a particular feature or new related module, please contact drunken_monkey. He is also available for consulting and custom development.