Wikipedia is a Python library that makes it easy to access and parse data from Wikipedia.
Search Wikipedia, get article summaries, get data like links and images from a page, and more. Wikipedia wraps the MediaWiki API so you can focus on using Wikipedia data, not getting it.
>>> import wikipedia
>>> print(wikipedia.summary("Wikipedia"))
Wikipedia ( (listen) wik-ih-PEE-dee-ə or (listen) wik-ee-) is a multilingual open-collaborative online encyclopedia created and maintained by a community of volunteer editors...
>>> wikipedia.search("Barack")
['Barack Obama', 'Family of Barack Obama', 'Barack Obama Sr.', 'Barack (disambiguation)', 'Presidency of Barack Obama', 'Barack Adama', 'Barack (name)', 'Barack Obama religion conspiracy theories', 'Early life and career of Barack Obama', 'Michelle Obama']
>>> ny = wikipedia.page("New York City")
>>> ny.title
'New York City'
>>> ny.url
'https://en.wikipedia.org/wiki/New_York_City'
>>> ny.content
'New York City (NYC), often called simply New York, is the most populous city in the United States.'...
>>> ny.links[0]
'10 Hudson Yards'
>>> wikipedia.set_lang("fr")
>>> wikipedia.summary("Python", sentences=1)
'Python (prononcé en anglais /ˈpaɪ.θɑn/) est un langage de programmation interprété, multi-paradigme et multiplateformes.'Note: this library was designed for ease of use and simplicity, not for advanced use. If you plan on doing serious scraping or automated requests, please use Pywikipediabot (or one of the other more advanced Python MediaWiki API wrappers), which has a larger API, rate limiting, and other features so we can be considerate of the MediaWiki infrastructure.
To install Wikipedia, simply run:
$ pip install wikipedia
Wikipedia is compatible with Python 2.6+ (2.7+ to run unittest discover) and Python 3.3+.
Read the docs at https://wikipedia.readthedocs.org/en/latest/.
To run tests, clone the repository on GitHub, then run:
$ pip install -r requirements.txt $ bash runtests # will run tests for python and python3 $ python -m unittest discover tests/ '*test.py' # manual style
in the root project directory.
To build the documentation yourself, after installing requirements.txt, run:
$ pip install sphinx $ cd docs/ $ make html
MIT licensed. See the LICENSE file for full details.
- wiki-api by @richardasaurus for inspiration
- @nmoroze and @themichaelyang for feedback and suggestions
- The Wikimedia Foundation for giving the world free access to data
