Guides
The reference tells you what every parameter does. These tell you which ones matter, and what happens when you get them wrong.
Choosing a ranking mode Keyword, semantic or hybrid — and why the right answer depends on who wrote the query. Stories for context windows The single biggest token saving available here, and when it is the wrong call. Time windows Why omitting from is expensive, what a plan bounds, and how to pick a range. Rate limits and backoff Two conditions share one status code. Only one is worth waiting for. Entity and signal filtering Finding coverage by what it is about rather than by what words it uses. Building a news agent An end-to-end agent over MCP, and the prompt that makes it use the right tool. Monitoring a topic A polling loop that does not duplicate, does not miss, and fits inside a quota. Evaluating coverage Measuring how much attention something got, with facets and outlet counts.
If you only read two
- Stories for context windows — the habit that most changes how well this API works for you.
- Time windows — the parameter that most changes what a request costs, and what it returns.