API:Categories
From MediaWiki.org
| Categories | ||
|---|---|---|
| List all categories the page(s) belong to. This module can be used as a Generator. |
||
| Prefix | cl | |
| Required rights | none | |
| Post only? | No | |
| Generated help | Current | |
| Version added |
|
|
Gets a list of all categories used on the provided pages. This module can be used as a generator.
Parameters[edit]
clprop: Which properties to get.sortkey: The sort key.timestamp: The date and time the page was added to the category, or the date and time its sortkey was changed last. 1.13+- : Whether the category is hidden or not. 1.16+
clshow: Which kinds of categories to list. Conflicting options (such ashiddenand!hidden) cannot be used together. 1.14+- : Only list hidden categories.
- : Don't list hidden categories.
cllimit: Maximum number of results to return. 1.13+clcontinue: When more results are available, use this to continue. 1.13+clcategories: Only list these categories. Useful to check whether a certain page is in a certain category. Note: This parameter takes full titles, so the Category: prefix must be used. 1.15+cldir: The direction in which to list. Possible values:ascending,descending. (Default:ascending) 1.20+
Example[edit]
Get a list of categories en:Albert Einstein belongs to
| Result |
|---|
<api>
<query>
<pages>
<page pageid="736" ns="0" title="Albert Einstein">
<categories>
<cl ns="14" title="Category:1879 births" />
<cl ns="14" title="Category:1955 deaths" />
<cl ns="14" title="Category:Albert Einstein" />
...
</categories>
</page>
</pages>
</query>
</api>
|
Possible warnings[edit]
- 'title' is not a category
- The title mentioned is not in the Category: namespace
Possible errors[edit]
| Code | Info |
|---|---|
| clshow | Incorrect parameter - mutually exclusive values may not be supplied |
