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 (/ˌwɪkɨˈpiːdiə/ or /ˌwɪkiˈpiːdiə/ WIK-i-PEE-dee-ə) is a collaboratively edited, multilingual, free Internet encyclopedia supported by the non-profit Wikimedia Foundation...
>>> wikipedia.search("Barack")
# [u'Barak (given name)', u'Barack Obama', u'Barack (brandy)', u'Presidency of Barack Obama', u'Family of Barack Obama', u'First inauguration of Barack Obama', u'Barack Obama presidential campaign, 2008', u'Barack Obama, Sr.', u'Barack Obama citizenship conspiracy theories', u'Presidential transition of Barack Obama']
>>> ny = wikipedia.page("New York")
>>> ny.title
# u'New York'
>>> ny.url
# u'http://en.wikipedia.org/wiki/New_York'
>>> ny.content
# u'New York is a state in the Northeastern region of the United States. New York is the 27th-most exten'...
>>> ny.links[0]
# u'1790 United States Census'
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, the official MediaWiki scraper that has a larger API and includes rate limiting so we can be considerate of the MediaWiki infrastructure.
To install Wikipedia, simply run:
$ pip install wikipedia
Read the docs at https://wikipedia.readthedocs.org/en/latest/.
To run tests, clone the respository on GitHub, then run:
$ pip install -r requirements.txt $ nosetests
in the root project directory.
To build the documentation yourself, after installing requirements.txt, run:
$ 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