MediaWiki API help
This is an auto-generated MediaWiki API documentation page.
Documentation and examples: https://www.mediawiki.org/wiki/API
list=search (sr)
- This module requires read rights.
- This module can be used as a generator.
- Source: MediaWiki
- License: GPL-2.0+
Perform a full text search.
Parameters:
- srsearch
Search for page titles or content matching this value. You can use the search string to invoke special search features, depending on what the wiki's search backend implements.
- This parameter is required.
- srnamespace
Search only within these namespaces.
- Values (separate with |): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 198, 199, 200, 201, 202, 203, 204, 205, 206, 207, 208, 209, 460, 461, 170, 171, 2300, 2301, 2302, 2303, 102, 103, 108, 109, 710, 711, 420, 421, 106, 107, 2600, 1198, 1199, 104, 105
- Maximum number of values is 50 (500 for bots).
- Default: 0
- srwhat
Which type of search to perform.
- One of the following values: title, text, nearmatch
- srinfo
Which metadata to return.
- Values (separate with |): totalhits, suggestion, rewrittenquery
- Default: totalhits|suggestion|rewrittenquery
- srprop
Which properties to return:
- size
- Adds the size of the page in bytes.
- wordcount
- Adds the word count of the page.
- timestamp
- Adds the timestamp of when the page was last edited.
- snippet
- Adds a parsed snippet of the page.
- titlesnippet
- Adds a parsed snippet of the page title.
- redirecttitle
- Adds the title of the matching redirect.
- redirectsnippet
- Adds a parsed snippet of the redirect title.
- sectiontitle
- Adds the title of the matching section.
- sectionsnippet
- Adds a parsed snippet of the matching section title.
- isfilematch
- Adds a boolean indicating if the search matched file content.
- categorysnippet
- Adds a parsed snippet of the matching category.
- score
- Deprecated and ignored.
- hasrelated
- Deprecated and ignored.
- Values (separate with |): size, wordcount, timestamp, snippet, titlesnippet, redirecttitle, redirectsnippet, sectiontitle, sectionsnippet, isfilematch, categorysnippet, score, hasrelated
- Default: size|wordcount|timestamp|snippet
- sroffset
When more results are available, use this to continue.
- Type: integer
- Default: 0
- srlimit
How many total pages to return.
- No more than 50 (500 for bots) allowed.
- Type: integer or max
- Default: 10
- srinterwiki
Include interwiki results in the search, if available.
- Type: boolean (details)
- srenablerewrites
Enable internal query rewriting. Some search backends can rewrite the query into one its thinks gives better results, such as correcting spelling errors.
- Type: boolean (details)
Examples:
- Search for meaning.
- api.php?action=query&list=search&srsearch=meaning
- Search texts for meaning.
- api.php?action=query&list=search&srwhat=text&srsearch=meaning
- Get page info about the pages returned for a search for meaning.
- api.php?action=query&generator=search&gsrsearch=meaning&prop=info