published_from / published_to
unix timestampBounds results by content date — when the page says it was published.
The recency people usually mean. A page crawled yesterday may have been published in 2019, and for most questions the publication date is the one that determines whether the information is current.
Not every page carries a reliable date. Passages without one are excluded when this filter is set, which is the conservative behaviour but does narrow the pool.
Example
curl -H "x-api-key: $UNLOB_API_KEY" \
"https://api.unlob.com/search?q=model+release&published_from=1767225600"Common questions
What does the published_from / published_to filter do?
Bounds results by content date — when the page says it was published.
When should I use published_from / published_to?
Almost any question where currency matters. Default to this over `from`/`to`.
How does published_from / published_to behave in practice?
Not every page carries a reliable date. Passages without one are excluded when this filter is set, which is the conservative behaviour but does narrow the pool.
Filters are free
Every filter is evaluated against a stored field, so it narrows the candidate set before scoring — a filtered query is often faster than an unfiltered one.