Estimate a fetch (no call)
liquid_estimateRead-onlyIdempotent
Estimate the cost of any API fetch before calling it: predicted item count, bytes, tokens, credits, and latency. Decide whether to narrow your request first to save resources.
Instructions
Pre-flight estimate for a fetch — predicted item count, bytes, tokens, credits and latency, each with a confidence and source — without making any HTTP call or LLM call. Read-only and free. Returns {estimate: {...}}. Check this before a potentially large liquid_fetch to decide whether to narrow the pull with liquid_query (filter/aggregate) first. Requires an adapter_id from liquid_connect.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adapter_id | Yes | An adapter id returned by liquid_connect (or listed by liquid_list_adapters). | |
| endpoint | No | Optional endpoint path to act on (e.g. "/users"); defaults to the adapter's primary endpoint. Use a path shown by liquid_connect / liquid_list_adapters. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| estimate | No | Predicted items, bytes, tokens, credits, latency with confidence + source. | |
| error | No |