/api/v1/endpoints
Access the complete programmatic interface for searching, retrieving, and submitting historical web content. All endpoints return JSON and support pagination.
🔑 Authentication
All requests require a valid API key passed in the `Authorization` header. Keys can be generated from your developer dashboard.
Authorization: Bearer your_api_key_here
Search the archive using full-text, URL patterns, or metadata filters. Supports era-specific queries and boolean logic.
| Parameter | Type | Description |
|---|---|---|
| q REQUIRED | string | Search query or URL pattern |
| year_start | integer | Filter by start year (e.g., 1993) |
| year_end | integer | Filter by end year (e.g., 1999) |
| limit | integer | Results per page (max 100) |
Response Example:
{
"status": "success",
"count": 42,
"results": [
{ "url": "http://example.geocities.com/90s/123", "snapshots": 5, "latest": "1998-04-12" }
]
}
Retrieve a specific archived snapshot. Returns HTML, CSS, and embedded assets exactly as preserved.
| Parameter | Type | Description |
|---|---|---|
| url_id | string | Archived URL identifier |
| timestamp | string | ISO 8601 date for specific snapshot |
| format | enum | html, json, memento (default: html) |
Submit a modern or dead URL for archival processing. Our crawler will attempt preservation using legacy-compatible rendering engines.
| Parameter | Type | Description |
|---|---|---|
| url REQUIRED | string | Target URL to archive |
| depth | integer | Crawl depth (1-5) |
| callback | string | Webhook URL for completion notification |
Fetch preservation metadata, integrity hashes, capture tools used, and cryptographic verification signatures.
| Parameter | Type | Description |
|---|---|---|
| id | string | Archive record ID |
| include_hashes | boolean | Return SHA-256 verification hashes |
Cancel a pending or active crawl job. Already completed snapshots remain in the archive.
| Parameter | Type | Description |
|---|---|---|
| job_id | string | Async job identifier from POST /crawl |
âš¡ Rate Limits & Tiers
Free Tier
Requests / hour
Researcher
Requests / hour
Enterprise
Dedicated crawler nodes
Response Size
Max payload per snapshot