API:Allfileusages

This page is part of the MediaWiki action API documentation.

MediaWiki APIsAPI:Main page

• Web APIs showcaseAPI:Web APIs hub
• REST content API

MediaWiki action API

• Introduction and quick startAPI:Main page
• FAQAPI:FAQ
  • Etiquette and usage limitsAPI:Etiquette
• FormatsAPI:Data formats
• Error reportingAPI:Errors and warnings
• Restricting usageAPI:Restricting API usage
• Cross-site requestsAPI:Cross-site requests
• Authentication
  • LoginAPI:Login
  • LogoutAPI:Logout
  • Account creationAPI:Account creation
• QueriesAPI:Query
  • Meta informationAPI:Meta
  • PropertiesAPI:Properties
  • ListsAPI:Lists
• Searching (by title, content, coordinates...)API:Search and discovery
• Parsing wikitext and expanding templatesAPI:Parsing wikitext
• Purging pages' cachesAPI:Purge
• Parameter informationAPI:Parameter information
• Changing wiki contentAPI:Changing wiki content
  • Create and edit pagesAPI:Edit
  • Move pagesAPI:Move
  • Merge pagesAPI:Mergehistory
  • RollbackAPI:Rollback
  • Delete pagesAPI:Delete
  • Restore deleted revisionsAPI:Undelete
  • (Un)protect pagesAPI:Protect
  • (Un)block usersAPI:Block
  • (Un)watch pagesAPI:Watch
  • Mark revisions of watched pages as visitedAPI:SetNotificationTimestamp
  • Send emailAPI:Email
  • Patrol changesAPI:Patrol
  • Import pagesAPI:Import
  • Change user group membershipAPI:User group membership
  • Upload filesAPI:Upload
  • User optionsAPI:Options
  • TokensAPI:Tokens
  • Page languageAPI:SetPageLanguage
  • More...API:Changing wiki content
• Watchlist feedAPI:Watchlist feed
• WikidataWikibase/API
• ExtensionsAPI:Extensions
• Using the API in MediaWiki and extensionsAPI:Calling internally
• MiscellaneousAPI:Other services
• ImplementationAPI:Implementation Strategy
  • LocalisationAPI:Localisation
• Client codeAPI:Client code
• AssertingAPI:Assert

Allfileusages
This module can be used as a GeneratorAPI:generator.
Prefix	af
Required rights	none
Post only?	No
Generated help	Current
Version added	≥ 1.22

List all file usages, including non-existing

Parameters

• afcontinue: When more results are available, use this to continue
• affrom: The title of the file to start enumerating from
• afto: The title of the file to stop enumerating at
• afprefix: Search for all file titles that begin with this value
• afunique: Only show distinct file titles. Cannot be used with afprop=ids. When used as a generator, yields target pages instead of source pages.
• afprop: What pieces of information to include (Default: title)
  • ids: Adds the pageid of the using page (cannot be used with afunique)
  • title: Adds the title of the file.
• aflimit: How many total items to return. No more than 500 (5000 for bots) allowed. (Default: 10)
• afdir: The direction in which to list Possible values: ascending, descending. (Default: ascending)

Example

List the first 10 used files starting with the word "Icon" and what page ids they're used on

api.php?action=query&list=allfileusages&afprefix=Icon&afprop=ids|title [try in ApiSandbox]

---

list=allfileusages (af)

(main | query | allfileusages)

• This module requires read rights.
• This module can be used as a generator.
• Source: MediaWiki
• License: GPL-2.0+

List all file usages, including non-existing.

• https://www.mediawiki.org/wiki/Special:MyLanguage/API:Allfileusages

Parameters:

afcontinue

When more results are available, use this to continue.

affrom

The title of the file to start enumerating from.

afto

The title of the file to stop enumerating at.

afprefix

Search for all file titles that begin with this value.

afunique

Only show distinct file titles. Cannot be used with afprop=ids.

When used as a generator, yields target pages instead of source pages.

Type: boolean (details)

afprop

Which pieces of information to include:

ids

Adds the page IDs of the using pages (cannot be used with afunique).

title

Adds the title of the file.

Values (separate with | or alternative): ids, title

Default: title

aflimit

How many total items to return.

No more than 500 (5,000 for bots) allowed.

Type: integer or max

Default: 10

afdir

The direction in which to list.

One of the following values: ascending, descending

Default: ascending

Examples:

List file titles, including missing ones, with page IDs they are from, starting at B.

api.php?action=query&list=allfileusages&affrom=B&afprop=ids|title [open in sandbox]

List unique file titles.

api.php?action=query&list=allfileusages&afunique=&affrom=B [open in sandbox]

Gets all file titles, marking the missing ones.

api.php?action=query&generator=allfileusages&gafunique=&gaffrom=B [open in sandbox]

Gets pages containing the files.

api.php?action=query&generator=allfileusages&gaffrom=B [open in sandbox]