Bowmark AIdocs

Wayback Machine (archive.org)

The Wayback Machine — is a site or page archived, every capture it holds, and the page itself as it was captured, so a caller can see what a site…

The Wayback Machine — is a site or page archived, every capture it holds, and the page itself as it was captured, so a caller can see what a site published before it was changed or removed.

Domain: archive.org

Also known as: Wayback Machine, archive.org, Internet Archive

Prefer the capability

bowmark.booking_links covers this provider and routes around it when it is having a bad day. Reach for this page when you need archive.org specifically.

Call it directly

bowmark.providers.archive_org.listSnapshots(site: string, opts?: archive_orgSnapshotOptions): Promise<archive_orgSnapshotList>
bowmark.providers.archive_org.getSnapshot(url: string, timestamp: string): Promise<archive_orgSnapshotPage>
bowmark.providers.archive_org.checkAvailability(site: string, timestamp?: string): Promise<archive_orgAvailability>

Functions

FunctionWhat it does
listSnapshotsLists what the Wayback Machine has captured, newest first.
getSnapshotReads one archived page as it was captured — the original HTML, without the archive's toolbar or rewritten links — for a url and a YYYYMMDDhhmmss timestamp from listSnapshots (a nearby…
checkAvailabilityChecks the Wayback Machine's own public availability endpoint for one site or page — a bare domain ("carpetlandusa.net"), a domain plus path ("carpetlandusa.net/schedule-pre-measure/"), or…

Types

interface archive_orgAvailability {
  query: string;
  available: boolean;
  archivedUrl: string | null;
  archivedTimestamp: string | null;  // YYYYMMDDhhmmss
  archivedStatus: string | null;     // the original page's own HTTP status when captured
}

interface archive_orgSnapshotOptions {
  scope?: "exact" | "prefix";   // default: "prefix" for a bare domain (every page under it), "exact" for a url with a path
  limit?: number;               // 1-500, default 50 — newest first
  pathContains?: string[];      // keep only urls whose path contains one of these, e.g. ["about", "team", "contact"]
}

interface archive_orgSnapshot {
  timestamp: string;            // YYYYMMDDhhmmss
  originalUrl: string;
  archivedUrl: string;          // the browsable capture, web.archive.org/web/<ts>/<url>
  statusCode: string;
  mimeType: string;
}

interface archive_orgSnapshotList {
  query: string;
  scope: "exact" | "prefix";
  snapshots: archive_orgSnapshot[];   // prefix: newest capture of each distinct url; exact: each distinct VERSION of the page
  warnings: string[];
}

interface archive_orgSnapshotPage {
  originalUrl: string;
  timestamp: string;
  archivedUrl: string;
  html: string;                 // the ORIGINAL bytes as captured, without the archive's toolbar or rewritten links
  warnings: string[];
}
booking_linksBooking links — find a person's Calendly or Cal.com link and read its form — the capability this provider backs.
cal_comAlso backs the same capability.
calendlyAlso backs the same capability.
githubAlso backs the same capability.
serperAlso backs the same capability.