MediaWiki API help
This is an auto-generated MediaWiki API documentation page.
Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=allimages (ai)
- This module requires read rights.
- This module can be used as a generator.
- Source: MediaWiki
- License: GPL-2.0-or-later
Enumerate all images sequentially.
- aisort
Property to sort by.
- One of the following values: name, timestamp
- Default: name
- aidir
The direction in which to list.
- One of the following values: ascending, descending, newer, older
- Default: ascending
- aifrom
The image title to start enumerating from. Can only be used with aisort=name.
- aito
The image title to stop enumerating at. Can only be used with aisort=name.
- aicontinue
When more results are available, use this to continue.
- aistart
The timestamp to start enumerating from. Can only be used with aisort=timestamp.
- Type: timestamp (allowed formats)
- aiend
The timestamp to end enumerating. Can only be used with aisort=timestamp.
- Type: timestamp (allowed formats)
- aiprop
Which file information to get:
- timestamp
- Adds timestamp for the uploaded version.
- user
- Adds the user who uploaded each file version. If the user has been revision deleted, a userhidden property will be returned.
- userid
- Add the ID of the user that uploaded each file version. If the user has been revision deleted, a userhidden property will be returned.
- comment
- Comment on the version. If the comment has been revision deleted, a commenthidden property will be returned.
- parsedcomment
- Parse the comment on the version. If the comment has been revision deleted, a commenthidden property will be returned.
- canonicaltitle
- Adds the canonical title of the file. If the file has been revision deleted, a filehidden property will be returned.
- url
- Gives URL to the file and the description page. If the file has been revision deleted, a filehidden property will be returned.
- size
- Adds the size of the file in bytes and the height, width and page count (if applicable).
- dimensions
- Alias for size.
- sha1
- Adds SHA-1 hash for the file. If the file has been revision deleted, a filehidden property will be returned.
- mime
- Adds MIME type of the file. If the file has been revision deleted, a filehidden property will be returned.
- mediatype
- Adds the media type of the file. If the file has been revision deleted, a filehidden property will be returned.
- metadata
- Lists Exif metadata for the version of the file. If the file has been revision deleted, a filehidden property will be returned.
- commonmetadata
- Lists file format generic metadata for the version of the file. If the file has been revision deleted, a filehidden property will be returned.
- extmetadata
- Lists formatted metadata combined from multiple sources. Results are HTML formatted. If the file has been revision deleted, a filehidden property will be returned.
- bitdepth
- Adds the bit depth of the version. If the file has been revision deleted, a filehidden property will be returned.
- badfile
- Adds whether the file is on the MediaWiki:Bad image list
- Values (separate with | or alternative): badfile, bitdepth, canonicaltitle, comment, commonmetadata, dimensions, extmetadata, mediatype, metadata, mime, parsedcomment, sha1, size, timestamp, url, user, userid
- Default: timestamp|url
- aiprefix
Search for all image titles that begin with this value. Can only be used with aisort=name.
- aiminsize
Limit to images with at least this many bytes.
- Type: integer
- aimaxsize
Limit to images with at most this many bytes.
- Type: integer
- aisha1
SHA1 hash of image. Overrides aisha1base36.
- aisha1base36
SHA1 hash of image in base 36 (used in MediaWiki).
- aiuser
Only return files uploaded by this user. Can only be used with aisort=timestamp. Cannot be used together with aifilterbots.
- Type: user, by any of user name, IP, interwiki name (e.g. "prefix>ExampleName") and user ID (e.g. "#12345")
- aifilterbots
How to filter files uploaded by bots. Can only be used with aisort=timestamp. Cannot be used together with aiuser.
- One of the following values: all, bots, nobots
- Default: all
- aimime
What MIME types to search for, e.g. image/jpeg.
- Separate values with |.
- Maximum number of values is 50 (500 for clients allowed higher limits).
- ailimit
How many images in total to return.
- Type: integer or max
- The value must be between 1 and 500.
- Default: 10
- Show a list of files starting at the letter B.
- api.php?action=query&list=allimages&aifrom=B [open in sandbox]
- Show a list of recently uploaded files, similar to Special:NewFiles.
- api.php?action=query&list=allimages&aiprop=user|timestamp|url&aisort=timestamp&aidir=older [open in sandbox]
- Show a list of files with MIME type image/png or image/gif
- api.php?action=query&list=allimages&aimime=image/png|image/gif [open in sandbox]
- Show info about 4 files starting at the letter T.
- api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo [open in sandbox]