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:Example output · results vary
published_at if your agent needs a timeline.
Read the dates in the response
Each result carriespublished_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 thepublished_ 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
- Date and time filters: every format, with resolved examples.
- Search request:
published_after,acquired_afterandquery_timein full. - Filter by domain: combine a date window with a site.