edgi-govdata-archiving / wayback

Licence: BSD-3-Clause license
A Python API to the Internet Archive Wayback Machine

Programming Languages

python
139335 projects - #7 most used programming language

wayback

Build Status Download Latest Version from PyPI Code of Conduct Documentation Status

Wayback is A Python API to the Internet Archive’s Wayback Machine. It gives you tools to search for and load mementos (historical copies of web pages).

The Internet Archive maintains an official “internetarchive” Python package, but it does not focus on the Wayback Machine. Instead, it is mainly concerned with the APIs and tools that manage the Internet Archive as a whole: managing items and collections. These are how e-books, audio recordings, movies, and other content in the Internet Archive are managed. It doesn’t, however, provide particularly good tools for finding or loading historical captures of specific URLs (i.e. the part of the Internet Archive called the “Wayback Machine”). That’s what this package does.

Installation & Basic Usage

Install via pip on the command line:

$ pip install wayback

Then, in a Python script, import it and create a client:

import wayback
client = wayback.WaybackClient()

Finally, search for all the mementos of nasa.gov before 1999 and download them:

for record in client.search('http://nasa.gov', to_date=date(1999, 1, 1)):
    memento = client.get_memento(record)

Read the full documentation for a more in-depth tutorial and complete API reference documentation at https://wayback.readthedocs.io/

Code of Conduct

This repository falls under EDGI’s Code of Conduct. Please take a moment to review it before commenting on or creating issues and pull requests.

Contributors

Thanks to the following people for their contributions and help on this package! See our contributing guidelines to find out how you can help.

License & Copyright

Copyright (C) 2019-2022 Environmental Data and Governance Initiative (EDGI)

This program is free software: you can redistribute it and/or modify it under the terms of the 3-Clause BSD License. See the LICENSE file for details.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].