This page is a translated version of the page API:Categories and the translation is 100% complete.
Versión de MediaWiki:

Solicitud GET para ver categorías asociado a una página o páginas.

Este módulo puede ser utilizado como generator .

API Documentación

prop=categories (cl)

(main | query | categories)
  • This module requires read rights.
  • This module can be used as a generator.
  • Source: MediaWiki
  • License: GPL-2.0-or-later

List all categories the pages belong to.

Specific parameters:
Other general parameters are available.

Which additional properties to get for each category:

Adds the sortkey (hexadecimal string) and sortkey prefix (human-readable part) for the category.
Adds timestamp of when the category was added.
Tags categories that are hidden with __HIDDENCAT__.
Values (separate with | or alternative): hidden, sortkey, timestamp

Which kind of categories to show.

Values (separate with | or alternative): !hidden, hidden

How many categories to return.

Type: integer or max
The value must be between 1 and 500.
Default: 10

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.


Only list these categories. Useful for checking whether a certain page is in a certain category.

Separate values with | or alternative.
Maximum number of values is 50 (500 for clients that are allowed higher limits).

The direction in which to list.

One of the following values: ascending, descending
Default: ascending
Get a list of categories the page Albert Einstein belongs to.
api.php?action=query&prop=categories&titles=Albert%20Einstein [open in sandbox]
Get information about all categories used in the page Albert Einstein.
api.php?action=query&generator=categories&titles=Albert%20Einstein&prop=info [open in sandbox]


Solicitud GET

Solicitud GET para ver categorías en una página.


    "continue": {
        "clcontinue": "13828397|Afrofuturists",
        "continue": "||"
    "query": {
        "pages": {
            "13828397": {
                "pageid": 13828397,
                "ns": 0,
                "title": "Janelle Mon\u00e1e",
                "categories": [
                        "ns": 14,
                        "title": "Category:1985 births"
                        "ns": 14,
                        "title": "Category:21st-century American actresses"
                        "ns": 14,
                        "title": "Category:21st-century American singers"

Código de muestra




    MediaWiki API Demos
    Demo of `Categories` module: Get categories associated with a page.

    MIT License

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

    "action": "query",
    "format": "json",
    "prop": "categories",
    "titles": "Janelle Monáe"

R = S.get(url=URL, params=PARAMS)
DATA = R.json()

PAGES = DATA["query"]["pages"]

for k, v in PAGES.items():
    for cat in v['categories']:



    MediaWiki API Demos
    Demo of `Categories` module: Get categories associated with a page.

    MIT License

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "query",
    "format" => "json",
    "prop" => "categories",
    "titles" => "Janelle Monáe"

$url = $endPoint . "?" . http_build_query( $params );

$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );

$result = json_decode( $output, true );

foreach( $result["query"]["pages"] as $k => $v ) {
    foreach( $v["categories"] as $k => $v ) {
        echo( $v["title"] . "\n" );



    MediaWiki API Demos
    Demo of `Categories` module: Get categories associated with a page.

    MIT License

var url = "https://en.wikipedia.org/w/api.php"; 

var params = {
    action: "query",
    format: "json",
    prop: "categories",
    titles: "Janelle Monáe"

url = url + "?origin=*";
Object.keys(params).forEach(function(key){url += "&" + key + "=" + params[key];});

    .then(function(response){return response.json();})
    .then(function(response) {
        var pages = response.query.pages;
        for (var p in pages) {
            for (var cat of pages[p].categories) {

MediaWiki JS


	MediaWiki API Demos
	Demo of `Categories` module: Get categories associated with a page.

	MIT License

var params = {
		action: 'query',
		format: 'json',
		prop: 'categories',
		titles: 'Janelle Monáe'
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	var pages = data.query.pages,
	for ( p in pages ) {
		pages[ p ].categories.forEach( function ( cat ) {
			console.log( cat.title );
		} );
} );

Errores posibles

Código Info
clshow Parámetro incorrecto: no se pueden proporcionar valores mutuamente excluyentes.

Historial de parámetros

  • v1.20: Introducido cldir
  • v1.16: Introducido clprop=hidden
  • v1.15: Introducido clcategories
  • v1.14: Introducido clshow
  • v1.13: Introducido clcontinue, cllimit, clprop=timestamp

Véase también

  • API:Categorymembers - Páginas de lista que son miembros de una determinada categoría.
  • API:Allpages - Lista todas las páginas que se ajusten a ciertos criterios; también puede acceder a la categoría namespace .
  • API:Allcategories - un módulo list que obtiene categorías de todo el wiki, basado en ciertos criterios relacionados con el título de la categoría.