API:Opensearch

MediaWiki version:

= 1.9

This page is part of the MediaWiki API documentation.

Language:	English  • polski

MediaWiki API

Quick overview:

• Quick start guide
• FAQ
  • Etiquette and usage limits
• Tutorial
• Formats
• Error reporting
• Restricting usage
• Cross-site requests
• Authentication
  • Login
  • Logout
  • Account creation
• Queries
  • Meta information
  • Properties
  • Lists
• Search suggestions
• Parsing wikitext and expanding templates
• Purging pages' caches
• Parameter information
• Changing wiki content
  • Create and edit pages
  • Move pages
  • Rollback
  • Delete pages
  • Restore deleted revisions
  • (Un)protect pages
  • (Un)block users
  • (Un)watch pages
  • Send email
  • Patrol changes
  • Import pages
  • Change user group membership
  • Upload files
  • User options
• Watchlist feed
• Wikidata
• Extensions
• Using the API in MediaWiki and extensions
• Miscellaneous
• Implementation
• Client code

Opensearch
Get pages whose name matches a given string. When limit is reached, results are ordered by number of incoming links.
Prefix
Required rights	read
Post only?	No

Parameters

• search – the search string
• limit – maximum amount of results to return (defaults to 10)
• namespace – namespace numbers to search (delimited by |, defaults to 0)
• suggest – do nothing if $wgEnableOpenSearchSuggest is false
• format – see below

Error Codes

• readapidenied – You need read permission to use this module.

Note on case sensitivity

Page name searches are case-sensitive. If $wgCapitalLinks is true (this is the default), the first letter is case-insensitive. If the TitleKey extension is enabled, page name searches are entirely case-insensitive.

Example

The opensearch API module handles formats differently. Only XML and JSON (and their formatted versions) are recognized, every other valid format parameter results in JSON. The JSON format returns an array containing the search query and an array of result titles: JSON

api.php?action=opensearch&search=api&limit=10&namespace=0&format=jsonfm

The XML format returns an OpenSearch XML file with titles, URLs and short descriptions: XML

api.php?action=opensearch&search=api&limit=2&namespace=0&format=xmlfm

See also

• API:Search
• Extension:OpenSearchXml provides search plugin autodetection for browsers