MediaWiki API help
This is an auto-generated MediaWiki API documentation page.
Documentation and examples: https://www.mediawiki.org/wiki/API
prop=imageinfo (ii)
- This module requires read rights.
- Source: MediaWiki
- License: GPL-2.0+
Returns file information and upload history.
- iiprop
Which file information to get:
- timestamp
- Adds timestamp for the uploaded version.
- user
- Adds the user who uploaded each file version.
- userid
- Add the ID of the user that uploaded each file version.
- comment
- Comment on the version.
- parsedcomment
- Parse the comment on the version.
- canonicaltitle
- Adds the canonical title of the file.
- url
- Gives URL to the file and the description page.
- 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.
- mime
- Adds MIME type of the file.
- thumbmime
- Adds MIME type of the image thumbnail (requires url and param iiurlwidth).
- mediatype
- Adds the media type of the file.
- metadata
- Lists Exif metadata for the version of the file.
- commonmetadata
- Lists file format generic metadata for the version of the file.
- extmetadata
- Lists formatted metadata combined from multiple sources. Results are HTML formatted.
- archivename
- Adds the filename of the archive version for non-latest versions.
- bitdepth
- Adds the bit depth of the version.
- uploadwarning
- Used by the Special:Upload page to get information about an existing file. Not intended for use outside MediaWiki core.
- Values (separate with |): timestamp, user, userid, comment, parsedcomment, canonicaltitle, url, size, dimensions, sha1, mime, thumbmime, mediatype, metadata, commonmetadata, extmetadata, archivename, bitdepth, uploadwarning
- Default: timestamp|user
- iilimit
How many file revisions to return per file.
- No more than 500 (5,000 for bots) allowed.
- Type: integer or max
- Default: 1
- iistart
Timestamp to start listing from.
- Type: timestamp (allowed formats)
- iiend
Timestamp to stop listing at.
- Type: timestamp (allowed formats)
- iiurlwidth
If iiprop=url is set, a URL to an image scaled to this width will be returned. For performance reasons if this option is used, no more than 50 scaled images will be returned.
- Type: integer
- Default: -1
- iiurlheight
Similar to iiurlwidth.
- Type: integer
- Default: -1
- iimetadataversion
Version of metadata to use. If latest is specified, use latest version. Defaults to 1 for backwards compatibility.
- Default: 1
- iiextmetadatalanguage
What language to fetch extmetadata in. This affects both which translation to fetch, if multiple are available, as well as how things like numbers and various values are formatted.
- Default: en-gb
- iiextmetadatamultilang
If translations for extmetadata property are available, fetch all of them.
- Type: boolean (details)
- iiextmetadatafilter
If specified and non-empty, only these keys will be returned for iiprop=extmetadata.
- Separate values with |. Maximum number of values is 50 (500 for bots).
- iiurlparam
A handler specific parameter string. For example, PDFs might use page15-100px. iiurlwidth must be used and be consistent with iiurlparam.
- Default: (empty)
- iicontinue
When more results are available, use this to continue.
- iilocalonly
Look only for files in the local repository.
- Type: boolean (details)
- Fetch information about the current version of File:Albert Einstein Head.jpg.
- api.php?action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo [open in sandbox]
- Fetch information about versions of File:Test.jpg from 2008 and later.
- api.php?action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp|user|url [open in sandbox]
![[open in sandbox]](/wiki/Special:ApiSandbox#action=query&titles=File:Albert%20Einstein%20Head.jpg&prop=imageinfo){kind=link}
![[open in sandbox]](/wiki/Special:ApiSandbox#action=query&titles=File:Test.jpg&prop=imageinfo&iilimit=50&iiend=2007-12-31T23:59:59Z&iiprop=timestamp%7Cuser%7Curl){kind=link}