from / to
unix timestampBounds results by crawl time — when we fetched the page.
This is the fetch clock, not the publication clock. It answers "what did the index see in this window", which matters for reproducing a past result set or auditing what evidence existed at a point in time.
For "what was published recently", you almost certainly want published_from instead. Confusing the two is the single most common filter mistake.
Example
curl -H "x-api-key: $UNLOB_API_KEY" \
"https://api.unlob.com/search?q=budget&from=1704067200&to=1735689600"Common questions
What does the from / to filter do?
Bounds results by crawl time — when we fetched the page.
When should I use from / to?
Reproducibility and auditing. Rarely what you want for recency.
How does from / to behave in practice?
For "what was published recently", you almost certainly want `published_from` instead. Confusing the two is the single most common filter mistake.
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.