API:Globalusage

This page is part of the MediaWiki Action API documentation.

GET request to find all pages on other wikis that use the given files.

API documentation

The following documentation is the output of Special:ApiHelp/query+globalusage, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org).

prop=globalusage (gu)

(main | query | globalusage)

This module requires read rights.
Source: Global Usage
License: MIT

Returns global image usage for a certain image.

Specific parameters:

Other general parameters are available.

guprop

Which properties to return:

url: Adds url.
pageid: Adds page ID.
namespace: Adds namespace ID.

Values (separate with | or alternative): namespace, pageid, url

Default: url

gulimit

How many links to return.

Type: integer or max

The value must be between 1 and 500.

Default: 10

gunamespace

Limit results to these namespaces.

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 90, 91, 92, 93, 100, 101, 102, 103, 104, 105, 106, 107, 486, 487, 710, 711, 828, 829, 1198, 1199, 2600, 5500, 5501

To specify all values, use *.

Default: *

gusite

Limit results to these sites.

Values (separate with | or alternative): aawiki, aawikibooks, aawiktionary, abwiki, abwiktionary, acewiki, advisorswiki, advisorywiki, adywiki, aewikimedia, afwiki, afwikibooks, afwikiquote, afwiktionary, akwiki, akwikibooks, akwiktionary, alswiki, alswikibooks, alswikiquote, alswiktionary, altwiki, amiwiki, amwiki, amwikimedia, amwikiquote, amwiktionary, angwiki, angwikibooks, angwikiquote, angwikisource, angwiktionary, annwiki, anpwiki, anwiki, anwiktionary, apiportalwiki, arbcom_cswiki, arbcom_dewiki, arbcom_enwiki, arbcom_fiwiki, arbcom_itwiki, arbcom_nlwiki, arbcom_ruwiki, arcwiki, arwiki, arwikibooks, arwikimedia, arwikinews, arwikiquote, arwikisource, arwikiversity, arwiktionary, arywiki, arzwiki, astwiki, astwikibooks, astwikiquote, astwiktionary, aswiki, aswikibooks, aswikiquote, aswikisource, aswiktionary, atjwiki, auditcomwiki, avkwiki, avwiki, avwiktionary, awawiki, aywiki, aywikibooks, aywiktionary, azbwiki, azwiki, azwikibooks, azwikimedia, azwikiquote, azwikisource, azwiktionary, banwiki, banwikisource, barwiki, bat_smgwiki, bawiki, bawikibooks, bbcwiki, bclwiki, bclwikiquote, bclwikisource, bclwiktionary, bdrwiki, bdwikimedia, be_x_oldwiki, betawikiversity, bewiki, bewikibooks, bewikimedia, bewikiquote, bewikisource, bewiktionary, bewwiki, bgwiki, bgwikibooks, bgwikinews, bgwikiquote, bgwikisource, bgwiktionary, bhwiki, bhwiktionary, biwiki, biwikibooks, biwiktionary, bjnwiki, bjnwikiquote, bjnwiktionary, blkwiki, blkwiktionary, bmwiki, bmwikibooks, bmwikiquote, bmwiktionary, bnwiki, bnwikibooks, bnwikiquote, bnwikisource, bnwikivoyage, bnwiktionary, boardgovcomwiki, boardwiki, bowiki, bowikibooks, bowiktionary, bpywiki, brwiki, brwikimedia, brwikiquote, brwikisource, brwiktionary, bswiki, bswikibooks, bswikinews, bswikiquote, bswikisource, bswiktionary, btmwiki, btmwiktionary, bugwiki, bxrwiki, cawiki, cawikibooks, cawikimedia, cawikinews, cawikiquote, cawikisource, cawiktionary, cbk_zamwiki, cdowiki, cebwiki, cewiki, chairwiki, chapcomwiki, checkuserwiki, chowiki, chrwiki, chrwiktionary, chwiki, chwikibooks, chwiktionary, chywiki, ckbwiki, ckbwiktionary, cnwikimedia, collabwiki, commonswiki, cowiki, cowikibooks, cowikimedia, cowikiquote, cowiktionary, crhwiki, crwiki, crwikiquote, crwiktionary, csbwiki, csbwiktionary, cswiki, cswikibooks, cswikinews, cswikiquote, cswikisource, cswikiversity, cswikivoyage, cswiktionary, cuwiki, cvwiki, cvwikibooks, cywiki, cywikibooks, cywikiquote, cywikisource, cywiktionary, dagwiki, dawiki, dawikibooks, dawikiquote, dawikisource, dawiktionary, dewiki, dewikibooks, dewikinews, dewikiquote, dewikisource, dewikiversity, dewikivoyage, dewiktionary, dgawiki, dinwiki, diqwiki, diqwiktionary, dkwikimedia, donatewiki, dsbwiki, dtpwiki, dtywiki, dvwiki, dvwiktionary, dzwiki, dzwiktionary, ecwikimedia, eewiki, electcomwiki, elwiki, elwikibooks, elwikinews, elwikiquote, elwikisource, elwikiversity, elwikivoyage, elwiktionary, emlwiki, enwiki, enwikibooks, enwikinews, enwikiquote, enwikisource, enwikiversity, enwikivoyage, enwiktionary, eowiki, eowikibooks, eowikinews, eowikiquote, eowikisource, eowikivoyage, eowiktionary, eswiki, eswikibooks, eswikinews, eswikiquote, eswikisource, eswikiversity, eswikivoyage, eswiktionary, etwiki, etwikibooks, etwikimedia, etwikiquote, etwikisource, etwiktionary, euwiki, euwikibooks, euwikiquote, euwikisource, euwiktionary, execwiki, extwiki, fatwiki, fawiki, fawikibooks, fawikinews, fawikiquote, fawikisource, fawikivoyage, fawiktionary, fdcwiki, ffwiki, fiu_vrowiki, fiwiki, fiwikibooks, fiwikimedia, fiwikinews, fiwikiquote, fiwikisource, fiwikiversity, fiwikivoyage, fiwiktionary, fixcopyrightwiki, fjwiki, fjwiktionary, fonwiki, foundationwiki, fowiki, fowikisource, fowiktionary, frpwiki, frrwiki, frwiki, frwikibooks, frwikinews, frwikiquote, frwikisource, frwikiversity, frwikivoyage, frwiktionary, furwiki, fywiki, fywikibooks, fywiktionary, gagwiki, ganwiki, gawiki, gawikibooks, gawikiquote, gawiktionary, gcrwiki, gdwiki, gdwiktionary, gewikimedia, glkwiki, glwiki, glwikibooks, glwikiquote, glwikisource, glwiktionary, gnwiki, gnwikibooks, gnwiktionary, gomwiki, gomwiktionary, gorwiki, gorwikiquote, gorwiktionary, gotwiki, gotwikibooks, gpewiki, grantswiki, grwikimedia, gucwiki, gurwiki, guwiki, guwikibooks, guwikiquote, guwikisource, guwiktionary, guwwiki, guwwikinews, guwwikiquote, guwwiktionary, gvwiki, gvwiktionary, hakwiki, hawiki, hawiktionary, hawwiki, hewiki, hewikibooks, hewikinews, hewikiquote, hewikisource, hewikivoyage, hewiktionary, hifwiki, hifwiktionary, hiwiki, hiwikibooks, hiwikimedia, hiwikiquote, hiwikisource, hiwikiversity, hiwikivoyage, hiwiktionary, howiki, hrwiki, hrwikibooks, hrwikiquote, hrwikisource, hrwiktionary, hsbwiki, hsbwiktionary, htwiki, htwikisource, huwiki, huwikibooks, huwikinews, huwikiquote, huwikisource, huwiktionary, hywiki, hywikibooks, hywikiquote, hywikisource, hywiktionary, hywwiki, hzwiki, iawiki, iawikibooks, iawiktionary, ibawiki, id_internalwikimedia, idwiki, idwikibooks, idwikimedia, idwikiquote, idwikisource, idwikivoyage, idwiktionary, iegcomwiki, iewiki, iewikibooks, iewiktionary, iglwiki, igwiki, igwikiquote, igwiktionary, iiwiki, ikwiki, ikwiktionary, ilowiki, ilwikimedia, incubatorwiki, inhwiki, internalwiki, iowiki, iowiktionary, iswiki, iswikibooks, iswikiquote, iswikisource, iswiktionary, itwiki, itwikibooks, itwikinews, itwikiquote, itwikisource, itwikiversity, itwikivoyage, itwiktionary, iuwiki, iuwiktionary, jamwiki, jawiki, jawikibooks, jawikinews, jawikiquote, jawikisource, jawikiversity, jawikivoyage, jawiktionary, jbowiki, jbowiktionary, jvwiki, jvwikisource, jvwiktionary, kaawiki, kaawiktionary, kabwiki, kawiki, kawikibooks, kawikiquote, kawikisource, kawiktionary, kbdwiki, kbdwiktionary, kbpwiki, kcgwiki, kcgwiktionary, kgewiki, kgwiki, kiwiki, kjwiki, kkwiki, kkwikibooks, kkwikiquote, kkwiktionary, klwiki, klwiktionary, kmwiki, kmwikibooks, kmwiktionary, knwiki, knwikibooks, knwikiquote, knwikisource, knwiktionary, koiwiki, kowiki, kowikibooks, kowikinews, kowikiquote, kowikisource, kowikiversity, kowiktionary, krcwiki, krwiki, krwikiquote, kshwiki, kswiki, kswikibooks, kswikiquote, kswiktionary, kuswiki, kuwiki, kuwikibooks, kuwikiquote, kuwiktionary, kvwiki, kwwiki, kwwikiquote, kwwiktionary, kywiki, kywikibooks, kywikiquote, kywiktionary, labswiki, labtestwiki, ladwiki, lawiki, lawikibooks, lawikiquote, lawikisource, lawiktionary, lbewiki, lbwiki, lbwikibooks, lbwikiquote, lbwiktionary, legalteamwiki, lezwiki, lfnwiki, lgwiki, lijwiki, lijwikisource, liwiki, liwikibooks, liwikinews, liwikiquote, liwikisource, liwiktionary, lldwiki, lmowiki, lmowiktionary, lnwiki, lnwikibooks, lnwiktionary, loginwiki, lowiki, lowiktionary, lrcwiki, ltgwiki, ltwiki, ltwikibooks, ltwikiquote, ltwikisource, ltwiktionary, lvwiki, lvwikibooks, lvwiktionary, madwiki, madwiktionary, maiwiki, maiwikimedia, map_bmswiki, mdfwiki, mediawikiwiki, metawiki, mgwiki, mgwikibooks, mgwiktionary, mhrwiki, mhwiki, mhwiktionary, minwiki, minwiktionary, miwiki, miwikibooks, miwiktionary, mkwiki, mkwikibooks, mkwikimedia, mkwikisource, mkwiktionary, mlwiki, mlwikibooks, mlwikiquote, mlwikisource, mlwiktionary, mniwiki, mniwiktionary, mnwiki, mnwikibooks, mnwiktionary, mnwwiki, mnwwiktionary, moswiki, movementroleswiki, mowiki, mowiktionary, mrjwiki, mrwiki, mrwikibooks, mrwikiquote, mrwikisource, mrwiktionary, mswiki, mswikibooks, mswikisource, mswiktionary, mtwiki, mtwiktionary, muswiki, mwlwiki, mxwikimedia, myvwiki, mywiki, mywikibooks, mywikisource, mywiktionary, mznwiki, nahwiki, nahwikibooks, nahwiktionary, napwiki, napwikisource, nawiki, nawikibooks, nawikiquote, nawiktionary, nds_nlwiki, ndswiki, ndswikibooks, ndswikiquote, ndswiktionary, newiki, newikibooks, newiktionary, newwiki, ngwiki, ngwikimedia, niawiki, niawiktionary, nlwiki, nlwikibooks, nlwikimedia, nlwikinews, nlwikiquote, nlwikisource, nlwikivoyage, nlwiktionary, nnwiki, nnwikiquote, nnwiktionary, noboard_chapterswikimedia, nostalgiawiki, novwiki, nowiki, nowikibooks, nowikimedia, nowikinews, nowikiquote, nowikisource, nowiktionary, nqowiki, nrmwiki, nrwiki, nsowiki, nvwiki, nycwikimedia, nywiki, nzwikimedia, ocwiki, ocwikibooks, ocwiktionary, officewiki, olowiki, ombudsmenwiki, omwiki, omwiktionary, orwiki, orwikisource, orwiktionary, oswiki, otrs_wikiwiki, outreachwiki, pa_uswikimedia, pagwiki, pamwiki, papwiki, pawiki, pawikibooks, pawikisource, pawiktionary, pcdwiki, pcmwiki, pdcwiki, pflwiki, pihwiki, piwiki, piwiktionary, plwiki, plwikibooks, plwikimedia, plwikinews, plwikiquote, plwikisource, plwikivoyage, plwiktionary, pmswiki, pmswikisource, pnbwiki, pnbwiktionary, pntwiki, projectcomwiki, pswiki, pswikibooks, pswikivoyage, pswiktionary, ptwiki, ptwikibooks, ptwikimedia, ptwikinews, ptwikiquote, ptwikisource, ptwikiversity, ptwikivoyage, ptwiktionary, punjabiwikimedia, pwnwiki, qualitywiki, quwiki, quwikibooks, quwikiquote, quwiktionary, rmwiki, rmwikibooks, rmwiktionary, rmywiki, rnwiki, rnwiktionary, roa_rupwiki, roa_rupwiktionary, roa_tarawiki, romdwikimedia, rowiki, rowikibooks, rowikinews, rowikiquote, rowikisource, rowikivoyage, rowiktionary, rskwiki, rswikimedia, ruewiki, ruwiki, ruwikibooks, ruwikimedia, ruwikinews, ruwikiquote, ruwikisource, ruwikiversity, ruwikivoyage, ruwiktionary, rwwiki, rwwiktionary, sahwiki, sahwikiquote, sahwikisource, satwiki, sawiki, sawikibooks, sawikiquote, sawikisource, sawiktionary, scnwiki, scnwiktionary, scowiki, scwiki, scwiktionary, sdwiki, sdwikinews, sdwiktionary, searchcomwiki, sewiki, sewikibooks, sewikimedia, sgwiki, sgwiktionary, shiwiki, shnwiki, shnwikibooks, shnwikinews, shnwikivoyage, shnwiktionary, shwiki, shwiktionary, shywiktionary, simplewiki, simplewikibooks, simplewikiquote, simplewiktionary, siwiki, siwikibooks, siwiktionary, skrwiki, skrwiktionary, skwiki, skwikibooks, skwikiquote, skwikisource, skwiktionary, slwiki, slwikibooks, slwikiquote, slwikisource, slwikiversity, slwiktionary, smnwiki, smwiki, smwiktionary, snwiki, snwiktionary, sourceswiki, sowiki, sowiktionary, spcomwiki, specieswiki, sqwiki, sqwikibooks, sqwikinews, sqwikiquote, sqwiktionary, srnwiki, srwiki, srwikibooks, srwikinews, srwikiquote, srwikisource, srwiktionary, sswiki, sswiktionary, stewardwiki, stqwiki, strategywiki, stwiki, stwiktionary, suwiki, suwikibooks, suwikiquote, suwikisource, suwiktionary, svwiki, svwikibooks, svwikinews, svwikiquote, svwikisource, svwikiversity, svwikivoyage, svwiktionary, swwiki, swwikibooks, swwiktionary, sysop_itwiki, sysop_plwiki, szlwiki, szywiki, tawiki, tawikibooks, tawikinews, tawikiquote, tawikisource, tawiktionary, taywiki, tcywiki, tcywikisource, tcywiktionary, tddwiki, techconductwiki, tenwiki, test2wiki, testcommonswiki, testwiki, testwikidatawiki, tetwiki, tewiki, tewikibooks, tewikiquote, tewikisource, tewiktionary, tgwiki, tgwikibooks, tgwiktionary, thankyouwiki, thwiki, thwikibooks, thwikinews, thwikiquote, thwikisource, thwiktionary, tiwiki, tiwiktionary, tkwiki, tkwikibooks, tkwikiquote, tkwiktionary, tlwiki, tlwikibooks, tlwikiquote, tlwiktionary, tlywiki, tnwiki, tnwiktionary, towiki, towiktionary, tpiwiki, tpiwiktionary, transitionteamwiki, trvwiki, trwiki, trwikibooks, trwikimedia, trwikinews, trwikiquote, trwikisource, trwikivoyage, trwiktionary, tswiki, tswiktionary, ttwiki, ttwikibooks, ttwikiquote, ttwiktionary, tumwiki, twwiki, twwiktionary, tyvwiki, tywiki, u4cwiki, uawikimedia, udmwiki, ugwiki, ugwikibooks, ugwikiquote, ugwiktionary, ukwiki, ukwikibooks, ukwikimedia, ukwikinews, ukwikiquote, ukwikisource, ukwikivoyage, ukwiktionary, urwiki, urwikibooks, urwikiquote, urwiktionary, usabilitywiki, uzwiki, uzwikibooks, uzwikiquote, uzwiktionary, vecwiki, vecwikisource, vecwiktionary, vepwiki, vewiki, vewikimedia, viwiki, viwikibooks, viwikiquote, viwikisource, viwikivoyage, viwiktionary, vlswiki, votewiki, vowiki, vowikibooks, vowikiquote, vowiktionary, warwiki, wawiki, wawikibooks, wawikisource, wawiktionary, wbwikimedia, wg_enwiki, wikidatawiki, wikifunctionswiki, wikimania2005wiki, wikimania2006wiki, wikimania2007wiki, wikimania2008wiki, wikimania2009wiki, wikimania2010wiki, wikimania2011wiki, wikimania2012wiki, wikimania2013wiki, wikimania2014wiki, wikimania2015wiki, wikimania2016wiki, wikimania2017wiki, wikimania2018wiki, wikimaniateamwiki, wikimaniawiki, wowiki, wowikiquote, wowiktionary, wuuwiki, xalwiki, xhwiki, xhwikibooks, xhwiktionary, xmfwiki, yiwiki, yiwikisource, yiwiktionary, yowiki, yowikibooks, yowiktionary, yuewiktionary, zawiki, zawikibooks, zawikiquote, zawiktionary, zeawiki, zerowiki, zghwiki, zh_classicalwiki, zh_min_nanwiki, zh_min_nanwikibooks, zh_min_nanwikiquote, zh_min_nanwikisource, zh_min_nanwiktionary, zh_yuewiki, zhwiki, zhwikibooks, zhwikinews, zhwikiquote, zhwikisource, zhwikiversity, zhwikivoyage, zhwiktionary, zuwiki, zuwikibooks, zuwiktionary

Maximum number of values is 50 (500 for clients that are allowed higher limits).

gucontinue

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

gufilterlocal

Filter local usage of the file.

Type: boolean (details)

Example:

Get usage of File:Example.jpg: api.php?action=query&prop=globalusage&titles=File:Example.jpg [open in sandbox]

Caveats

skips the wiki where the files are stored, in the case of the WMF wiki farm, it skips all usage on wikimedia commons; to get translusions on that wiki, API:Fileusage must be used
lists only transclusions of files ([[File:...]]), not links to them ([[:File:...]]); locally the links can be gathered by API:Backlinks , but there is no way to gather them globally (other than querying single wikis one at a time)
the request can be sent to any wiki participating in the farm resulting in same uses listed; still it can be preferable to send it to the wiki where the files are stored in order to avoid useless details included in the answer such as complaints about the file locally not existing or translation of the namespace prefix File: into some other language

API documentation

prop=globalusage (gu)

Caveats

See also