Images

A page's image can come from the pageimage or thumbnail via get_query(), from an Infobox (via get_parse()), from Wikidata Property:P18 (via get_wikidata()), or from the RESTBase image or thumb (via get_rest()).

Image info is fetched by get_imageinfo() automatically, and stored in page.data['image']:

>>> page = wptools.page()
>>> page.get()
en.wikipedia.org (imageinfo) IMAGE_FILES
>>> page.data['image']
[
  {'kind': 'parse-image',     <imageinfo>},  # get_parse()
  {'kind': 'parse-cover',     <imageinfo>},  # get_parse()
  {'kind': 'query-pageimage', <imageinfo>},  # get_query()
  {'kind': 'query-thumbnail', <imageinfo>},  # get_query()
  {'kind': 'restbase-image',  <imageinfo>},  # get_restbase('/page/summary/{title}')
  {'kind': 'restbase-thumb',  <imageinfo>},  # get_restbase('/page/summary/{title}')
  {'kind': 'wikidata-image',  <imageinfo>},  # get_wikidata()
]

You can access image data more easily with page.images():

>>> page = wptools.page('Great Wave')
>>> page.get()
>>> page.images('kind')
[{'kind': 'query-pageimage'},
 {'kind': 'query-thumbnail'},
 {'kind': 'wikidata-image'},
 {'kind': 'wikidata-image'},
 {'kind': 'restbase-original'},
 {'kind': 'restbase-thumb'}]

>>> page.images(['kind','file'])
[{'file': u'File:Tsunami by hokusai 19th century.jpg',
  'kind': 'query-pageimage'},
 {'file': u'File:Tsunami by hokusai 19th century.jpg',
  'kind': 'query-thumbnail'},
 {'file': u'File:Great Wave off Kanagawa2.jpg', 'kind': 'wikidata-image'},
 {'file': u'File:Katsushika Hokusai - Thirty-Six Views of Mount Fuji- The Great Wave Off the Coast of Kanagawa - Google Art Project.jpg',
  'kind': 'wikidata-image'},
 {'file': u'File:Tsunami by hokusai 19th century.jpg',
  'kind': 'restbase-original'},
 {'file': u'File:320px-Tsunami by hokusai 19th century.jpg',
  'kind': 'restbase-thumb'}]

>>> page.images(['kind','file'], token='wikidata')
[{'file': u'File:Great Wave off Kanagawa2.jpg', 
  'kind': 'wikidata-image'},
 {'file': u'File:Katsushika Hokusai - Thirty-Six Views of Mount Fuji- The Great Wave Off the Coast of Kanagawa - Google Art Project.jpg',
  'kind': 'wikidata-image'}]

Further reading

• https://www.mediawiki.org/wiki/API:Images
• https://www.mediawiki.org/wiki/API:Imageinfo
• https://www.mediawiki.org/wiki/API:Licensing
• https://www.mediawiki.org/wiki/Extension:PageImages
• https://github.com/siznax/wptools/issues/14 Figure out "best" image