Registry / http-networking / savepagenow

savepagenow

JSON →
library1.3.1pypypi✓ verified 82d ago

savepagenow is a simple Python wrapper and command-line interface for archive.org’s 'Save Page Now' capturing service. It allows users to programmatically request that the Internet Archive save a specific URL. The library is currently at version 1.3.1 and maintains an active release cadence, primarily with dependency updates and important feature additions like authentication and rate limit documentation.

pip install savepagenow
INSTALL
IMPORT
SIG · SAVEPAGENOW
S
savepagenow
http-networkingpythonv1.3.1
Install
2.2s avg
Import
Disk
20MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v1.3.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 22.1MB
glibc
py 3.103.910 runs
installs and imports cleanly · install 2.2s · import 0.000s · 23MB
20MB installed
● package 20MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

capture
from savepagenow import capture
from savepagenow import save_page_now
capture_or_cache
from savepagenow import capture_or_cache
CachedPage
from savepagenow import CachedPage

This quickstart demonstrates how to use `savepagenow` to archive a URL. It includes an example of how to optionally pass authentication credentials, which are required for private captures. It's recommended to set `WAYBACK_ACCESS_KEY` and `WAYBACK_SECRET_KEY` environment variables for authenticated use.

import os from savepagenow import save_page_now # Replace with the URL you want to archive url_to_archive = "https://example.com/" # Optional: Set authentication credentials via environment variables or direct arguments # If you don't set these, captures will be public (if supported by IA) # For private captures, you'll need a Wayback Machine access key and secret. # WAYBACK_ACCESS_KEY='YOUR_ACCESS_KEY' # WAYBACK_SECRET_KEY='YOUR_SECRET_KEY' # Example using environment variables (recommended) access_key = os.environ.get('WAYBACK_ACCESS_KEY', '') secret_key = os.environ.get('WAYBACK_SECRET_KEY', '') try: if access_key and secret_key: print(f"Attempting to save {url_to_archive} with authentication...") archive = save_page_now( url_to_archive, auth_key=access_key, auth_secret=secret_key ) else: print(f"Attempting to save {url_to_archive} without authentication...") archive = save_page_now(url_to_archive) if archive.get('archive_url'): print(f"Page saved successfully: {archive['archive_url']}") else: print(f"Failed to save page. Response: {archive}") except Exception as e: print(f"An error occurred: {e}")
savepagenow --version
Debug
Known issues
gotchaThe Internet Archive's 'Save Page Now' service has implemented rate limits. Exceeding these limits will result in HTTP 429 (Too Many Requests) errors. Rapid, consecutive requests should be avoided or spaced out.
fix
Implement delays or exponential backoff between requests, especially when processing multiple URLs. Check the `savepagenow` README for the most current advice on rate limits.
affects: 1.3.1+
gotchaAuthentication is required for certain types of captures, particularly private ones. If you receive 401 Unauthorized or 403 Forbidden errors, it likely means your API keys are missing or invalid, or you lack the necessary permissions.
fix
Ensure you have valid `WAYBACK_ACCESS_KEY` and `WAYBACK_SECRET_KEY` set as environment variables or passed directly as `auth_key` and `auth_secret` arguments to `save_page_now`.
affects: 1.3.0+
gotchaThe Internet Archive's 'Save Page Now' service can sometimes be slow or temporarily unavailable. While `savepagenow` handles network requests, failures might occur due to upstream service issues.
fix
Implement robust error handling around your calls to `save_page_now`, including retries with delays for transient network or service errors.
affects: All versions
Upgrade
Version history
1.3.1latest on PyPI · released Jan 19, 2026
Audit
Dependencies
requestsrequiredUsed for making HTTP requests to the Internet Archive's API.
Agent activity
8 hits · last 30 days
node
6
OpenAI (training)
1
Resources
savepagenow — pip install savepagenow · libregistry