Mearman Submit URL to Wayback Machine
Submit a URL to the Internet Archive's Wayback Machine using the Save Page Now 2 (SPN2) API.
Usage
npx tsx scripts/submit.ts <url> [options]
Arguments
| Argument | Required | Description |
|---|---|---|
url |
Yes | URL to archive |
Options
| Option | Description |
|---|---|
--no-raw |
Include Wayback toolbar in archived URL |
--key=ACCESS:SECRET |
Use API authentication (get keys at https://archive.org/account/s3.php) |
Output
When submission succeeds:
✓ Archive submitted successfully
Job ID: spn2-abc123...
Check status: https://web.archive.org/save/status/spn2-abc123...
Waiting for capture...
✓ Capture complete
URL: https://web.archive.org/web/20240115123456id_/https://example.com
Script Execution (Preferred)
npx tsx scripts/submit.ts <url> [options]
Options:
--no-raw- Include Wayback toolbar in archived URL--key=ACCESS:SECRET- Use API authentication
Run from the wayback plugin directory: ~/.claude/plugins/cache/wayback/
Authentication
Get API keys at https://archive.org/account/s3.php (requires free account).
Header format:
Authorization: LOW {access_key}:{secret_key}
Rate Limits
| Limit | Authenticated | Anonymous |
|---|---|---|
| Concurrent captures | 12 | 6 |
| Daily captures | 100,000 | 4,000 |
| Per-URL daily | 10 | 10 |
| Capture timeout | 50s page load, 2min total |
SPN2 API
Endpoint: POST https://web.archive.org/save
Basic Request
curl -X POST https://web.archive.org/save \
-H "Accept: application/json" \
-H "Authorization: LOW myaccesskey:mysecret" \
-d "url=https://example.com"
Parameters
| Parameter | Description |
|---|---|
url |
URL to archive (required) |
capture_all=1 |
Capture even 4xx/5xx error pages |
capture_outlinks=1 |
Also archive linked pages (first 100) |
capture_screenshot=1 |
Generate PNG screenshot |
delay_wb_availability=1 |
Delay indexing ~12 hours (reduces load) |
skip_first_archive=1 |
Skip check if URL was already archived |
if_not_archived_within=30d |
Skip if archived within timeframe (e.g., 30d, 1h) |
js_behavior_timeout=10 |
Run JavaScript for N seconds (max 30) |
force_get=1 |
Use simple HTTP GET instead of browser |
capture_cookie=name=value |
Include custom cookie in request |
target_username / target_password |
Login credentials for protected pages |
Response
Success:
{
"url": "https://example.com",
"job_id": "spn2-abc123..."
}
Check Job Status
curl "https://web.archive.org/save/status/{job_id}" \
-H "Authorization: LOW myaccesskey:mysecret"
Pending:
{"status": "pending", "resources": []}
Success:
{
"status": "success",
"timestamp": "20240115123456",
"original_url": "https://example.com",
"resources": ["https://example.com/style.css"],
"outlinks": {},
"screenshot": "https://web.archive.org/web/.../screenshot.png"
}
Error codes: error:blocked-url, error:too-many-daily-captures, error:soft-time-limit-exceeded, error:invalid-host-resolution
Check Your Quota
curl "https://web.archive.org/save/status/user" \
-H "Authorization: LOW myaccesskey:mysecret"
Returns: {"available": 99950, "processing": 2}
Simple Method (No Auth)
For quick one-off saves without authentication:
https://web.archive.org/save/{URL}
Lower rate limits apply (6 concurrent, 4k daily).
- Use
delay_wb_availability=1for batch jobs (reduces server load) - Check job status for captures that take time (JS-heavy pages)
- Use
capture_screenshot=1for visual verification