Skip to main content
Keep your agent’s search results inside a date window, so it cites pages from the period the question is about. Set published_after for recent pages, add published_before to close the window, and use acquired_after when you want pages that are new to the index whatever their publish date.

Parameters

Every date filter takes a date, an ISO 8601 timestamp or a relative offset. See Choose a value.

Search a date window

This sample keeps pages published between 365 and 90 days before the request, and prints the publish date, title and URL of each of the top 5 results. It runs with no API key:
You see 5 results, each published inside the window. This run was made on 19 November 2026:
Example output · results vary
Results come in rank order, not date order. Sort them by published_at if your agent needs a timeline.

Read the dates in the response

Each result carries published_at and acquired_at as ISO 8601 timestamps in UTC, so your code can check the window or show the date next to a citation. This excerpt is from the curl request above, with max_results set to 2 and snippet_max_length to 180:
Response excerpt · results vary
published_at is when the page was published. acquired_at is when Keenable indexed it.

Choose a value

Each date filter takes one value in one of three formats. You can mix formats across the two ends of a window. A relative offset is <number><unit>, counted back from the request time and truncated to the minute. The units are min (minutes), h (hours), d (days), w (weeks), mo (30 days) and y (365 days).

Publish date or index date

Use the published_ filters when the question is about when something was written: news, release notes, papers. If you set published_after, the results leave out pages with no known publish date. Use the acquired_ filters when the question is about what is new to the index, or when the pages you want often have no publish date, such as documentation and product pages. This body returns pages Keenable indexed in the last 24 hours:

Common mistakes

In the SDKs, CLI and MCP

The filters keep their names in every client: published_after in Python and Rust, publishedAfter in TypeScript, PublishedAfter in Go. The CLI takes --published-after, --published-before, --acquired-after and --acquired-before (see CLI). Over MCP, search_web_pages takes the same four arguments (see MCP server).

API reference