hosting

GET /v1/site-imports/snapshots

What a web archive holds for a domain, by day.

Alle hosting Endpunkte

Authentifizierung

Senden Sie einen API-Schlüssel als Bearer-Token. Der Schlüssel muss über die Berechtigung sites.view verfügen; ein Schlüssel ohne diese wird mit 403 statt 404 abgelehnt.

Dieser Endpunkt erfordert keine Organisations-ID. Ihr Schlüssel identifiziert bereits die zugehörige Organisation, und die Antwort ist entsprechend eingeschränkt.

Ausprobieren

Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.

curl -X GET https://api.zinndigital.com/v1/site-imports/snapshots?domain=<domain> \
  -H "Authorization: Bearer zdk_live_…"

Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole

Details

The date picker's data for a Wayback restore. ⛔ **A cached database read, never a live archive call.** The Internet Archive's CDX index answered a two-row query in 41.9 seconds when measured on 2026-08-06, so an endpoint that blocked on it would hold a worker per customer and read as broken. When the cache is absent or stale this starts a durable refresh workflow and answers `202` with `state: "pending"`; poll it. `state` has four values and they are not interchangeable — `pending` (never fetched), `ready` (fresh), `stale` (usable but past its TTL, a refresh is running) and `error` (the archive refused, and the reason is in `error`). Requires `sites.view`.

Parameter

NameTypErforderlichWas es ist
domain (query)stringJaThe domain to look up, e.g. `example.com`. `www.` is ignored.

Antwort

NameTypErforderlichWas es ist
domainstringJa
statestring<pending, ready, stale, error>JaFour states, and they are not interchangeable — collapsing `error` into `pending` leaves a customer watching a spinner for something that will never arrive.
daysArchiveSnapshotDay[]Ja
total_capturesintegerJa
truncatedbooleanJaTrue when the archive stopped short of the whole index. Reported rather than swallowed: a picker showing the first 50,000 of 400,000 captures while implying completeness tells t…
errorstringJaWhy the last refresh failed; empty when it did not.
fetched_atstringNein

Fehler, die dieser Endpunkt zurückgeben kann

401 · 403 · 422 · 429