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.
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.
At the moment, this project contains, apart from the core API module, the following extension modules:
(Drupal 7 only)
This module integrates the Search API with the Views module, allowing searches on any index to be created and viewed via Views. All of an entity's properties, as well as those of related entities (e.g. a node's author's name), are available as fields, filters and arguments for all indexed fields are available and sorts (as well as click sorts) can be created on any indexed single-valued field. Also some additional features, like linking the results to the entity, are available.
For Drupal 8, Views integration is incorporated directly into the Search API module itself, it's not necessary to enable another module.
This module provides integration with the popular Facet API module to allow facetting on any search executed with the Search API, be it a search page, a view or any other source.
However, the feature is only supported by some backends – cf. the list of backends supporting the
(Drupal 8 only)
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 mor powerful backend (like Solr or Elastic Search).
For Drupal 7, this module is located in its own project.
Tutorials and screencasts
A number of tutorials and screencasts are linked in the handbook. Especially the latest screencasts from DrupalCon sessions might provide a good introduction to the module.
Other available backends and extensions
You can find a list of available extension modules in the handbook.
You will have to download and enable the Entity API module to use the Search API (Drupal 7 only).
To use the Views integration, you'll (of course) also need the Views module. For facets, you'll need the Facet API module.
Furthermore, you'll need to enable at least one module that provides a service class.
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
README.txt and directly in the relevant classes and interfaces) and partly in the online handbook.
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 onfor important updates. (Could also contain useful information for site builders.)
Drupal 8 version
A Drupal 8 version of the module is currently being worked on and already usable, though still some way from stable. If you want to follow (or, even better, help with) development, please see
Join #drupal-search-api on Freenode for helping out.
Please also note that, during Alpha phase, there is generally no upgrade path between versions of this module and that any new release might break your site without warning.
#D8CX: I pledge that I will try my best to make Search API have a full Drupal 8 release on the day that Drupal 8 is released.
If you are interested in sponsoring a particular feature or new related module, please contact me. I'm also available for consulting and custom development.