Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kagisearch/kite-public/llms.txt

Use this file to discover all available pages before exploring further.

Time Travel lets you step back in time and read the news exactly as it was on any past day. Rather than replacing your current view, it loads a historical batch of stories from Kagi’s archive so you can explore what was happening on a specific date.
Historical data is available back to January 1, 2024. Time Travel is currently marked as Beta and is available to all users during the beta period.

How to use Time Travel

1

Open the Time Travel modal

Click the Time Travel button in the top navigation bar (the clock icon). The calendar modal will open, showing the current month.
2

Navigate to the month you want

Use the and arrows to move between months. You can also click the month/year header to reveal a year selector dropdown, which is useful for jumping back further.Days that have available news batches display a small blue dot indicator. Days outside the January 2024 – today range are dimmed and cannot be selected.
3

Select a day

Click any highlighted day. If the day has exactly one batch, Time Travel loads that batch immediately. If the day has multiple batches (Kagi typically publishes updates several times per day), a batch selector slides in showing each update’s publication time and story count.
4

Choose a batch (if multiple exist)

Each listed batch shows:
  • Its publication time (e.g., 9:41 AM)
  • Total story count
  • A Latest badge on the most recent batch for that day
Click a batch to load it.
5

Browse historical stories

The feed switches to the selected batch. The URL updates to include the batch date slug so you can bookmark or share the exact view. All categories, search, and story features work normally in historical batches.
6

Return to today

Click Go to Today in the Time Travel modal, or open the modal and click the Go to Today button. This exits Time Travel and reloads the latest batch.

Batch date slugs and URLs

Every batch has a dateSlug in the format YYYY-MM-DD.N, where N is the sequential batch number for that day (starting at 1 for the earliest batch):
2025-01-15.1   ← First batch on January 15, 2025
2025-01-15.2   ← Second batch on the same day
When you navigate to a historical batch, the URL reflects the batch and the active category in compact form (YYYYMMDDN where N is the sequence number):
/technology/202501151
/world/202501152
This means any URL you copy while time traveling will take anyone who opens it to exactly the same historical batch and category — including category order and story content as it appeared at that time. Because the batch slug is part of the URL, sharing is as simple as copying the address bar. Recipients do not need a Kagi account to view the historical batch, though some features (such as settings sync) require sign-in.

Technical details

The Time Travel component fetches batch metadata from the batches API:
GET /api/batches?from=<ISO date>&to=<ISO date>&lang=<lang>
GET /api/batches/latest?lang=<lang>
Batches within each day are sorted newest-first. Before navigating, the component checks whether the selected batch is actually the current latest batch; if it is, it exits Time Travel rather than loading a “historical” view of the same content. The minimum supported date is hardcoded as new Date(2024, 0, 1) (January 1, 2024) and the maximum is always the current day adjusted to end-of-day to avoid timezone edge cases.

Build docs developers (and LLMs) love