How each endpoint is priced
Endpoint details:
- Search: search modes
- Fetch: content retrieval
- News: news feeds
What is not charged
- Failed fetches.
422and503responses from the fetch endpoint are free. - Search extracts.
extracts=trueadds passage-level text to each search result at no additional cost. - The news topics index.
GET /api/v1/newsis free.
See the cost of each call
Every response reports what it cost, in USD, after any discounts:- JSON responses:
metrics.cost_dollars format=contextresponses:cost_dollarsin the frontmatter
Control your spend
- Use
auto(the default) for most traffic. Simple queries stay cheap even when your mix includes hard ones. - Pin a search mode when you want more uniform cost from call to call.
low-costhas a cost ceiling. - Cap page text with
maxContentLengthandlimitwhen you request full content, because returned content is charged per token. - Use search
extracts=trueinstead of fetching each result page when passages are enough.
402. See error handling.
