Re-read a cached result for free

Re-read the full unshaped result of a prior run from its short-lived cache and re-shape it with the same fields, max_items, summary, and jq query params as /v1/run, all for FREE (no re-billing). Results are scoped to the customer that paid for them and cached for about 15 minutes. Use this to read the rest of, or reshape, a paid result instead of re-running and paying again.

get/v1/results/{id}

Request

  • Base URL: https://api.getanyapi.com
  • URL: https://api.getanyapi.com/v1/results/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

idstring required

The resultId returned on a prior run response envelope.

Query parameters

fieldsstring

Optional. Comma-separated keys (dotted paths like author.name descend into nested objects) to keep on each result item: each row of the API's result list, or the data object itself for an API that returns one record. Keys are matched relative to that item, not against the top-level response envelope, so use jq to reshape the whole envelope. Shrinks the response without changing cost.

max_itemsinteger

Optional. Cap the number of result rows returned; a _truncated note reports how many were withheld so you can page via the API's own limit. An API that returns one record is not trimmed. Does not change cost.

summaryboolean

Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost.

jqstring

Optional. A jq expression applied to the result envelope; its output replaces output (multiple outputs collect into an array). Reshape freely, e.g. jq=.data | {title, description, md: .markdown[:3500]}. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a jqError. Does not change cost.

Response

The re-shaped result envelope (same shape as a run response).

costUsdnumber required

USD charged on the ORIGINAL run, echoed for envelope parity; this re-read is free.

itemsinteger required

Number of result rows returned by the original run; an API that returns one record counts it as one row.

jqErrorstring

Present only when a jq expression failed; output then carries the full unshaped result and this explains why the reshape did not apply.

outputunknown required
providerstring required

Always "AnyAPI".

replayedboolean required

False on this cached-result endpoint; true is reserved for durable idempotency replays from POST /v1/run/{sku}.

resultIdstring

The id you requested, echoed so you can keep re-reading the same cached result.

Changes

No recorded changes to this operation across all 1 revision of this API.