levalencia Web Archive Scraper
Search the Wayback Machine (Internet Archive) for archived snapshots of websites. Fetch cached page content to find customer lists, testimonials, partner directories, and other information from sites that have changed or shut down.
Quick Start
Only dependency is requests. No API key needed.
# Find all snapshots of a URL
python3 skills/web-archive-scraper/scripts/search_archive.py \
--url "https://botkeeper.com/customers"
# Search with date range
python3 skills/web-archive-scraper/scripts/search_archive.py \
--url "https://botkeeper.com" --from 2025-01-01 --to 2026-02-01
# Search all pages under a domain (prefix match)
python3 skills/web-archive-scraper/scripts/search_archive.py \
--url "https://botkeeper.com" --match prefix --limit 50
# Fetch the actual archived page content
python3 skills/web-archive-scraper/scripts/search_archive.py \
--url "https://botkeeper.com/customers" --fetch
# Output formats
python3 skills/web-archive-scraper/scripts/search_archive.py --url URL --output json
python3 skills/web-archive-scraper/scripts/search_archive.py --url URL --output csv
python3 skills/web-archive-scraper/scripts/search_archive.py --url URL --output summary
How It Works
- CDX API search — Queries
web.archive.org/cdx/search/cdxfor snapshots matching the URL - Filtering — Filters by date range, HTTP status code, and MIME type
- Dedup — Collapses to one snapshot per day by default to avoid redundant results
- Content fetch — Optionally fetches the raw archived HTML (using
id_modifier to skip Wayback toolbar) - Text extraction — Strips HTML tags for readable text output when fetching content
CLI Reference
| Flag | Default | Description |
|---|---|---|
--url |
required | Target URL to search in the archive |
--match |
exact | Match type: exact, prefix, host, domain |
--from |
none | Start date (YYYY-MM-DD) |
--to |
none | End date (YYYY-MM-DD) |
--limit |
25 | Max number of snapshots to return |
--fetch |
false | Fetch and display the content of the most recent snapshot |
--fetch-all |
false | Fetch content of ALL matched snapshots (use with small --limit) |
--status |
200 | HTTP status filter (set to "any" to include all) |
--output |
json | Output format: json, csv, summary |
--collapse |
day | Dedup level: none, day, month, year |
Output Schema
{
"url": "https://botkeeper.com/customers",
"timestamp": "20250915143022",
"datetime": "2025-09-15T14:30:22",
"status_code": "200",
"mime_type": "text/html",
"archive_url": "https://web.archive.org/web/20250915143022/https://botkeeper.com/customers",
"raw_url": "https://web.archive.org/web/20250915143022id_/https://botkeeper.com/customers",
"content": "..."
}
The content field is only populated when --fetch or --fetch-all is used.
Cost
Free. The Wayback Machine CDX API requires no authentication or API key. Rate limit is ~15 requests/minute.
Common Use Cases
- Find customer lists from shut-down companies (e.g., botkeeper.com)
- Recover testimonials/case studies before a site redesign
- Track how a competitor's messaging changed over time
- Find partner directories that have been removed