Re-fetch cached results

Retrieve previously returned search results using the queryId from a prior search response. Returns the same results without billing. The request must use the same API key that performed the original search. Results are available for 7 days. Each result carries locked/tokens/cost: a result not yet paid for through POST /api/v1/search/unlock comes back as a teaser (locked: true), never the full text.

GET/api/v1/search/results/{queryId}

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Pass your key in the Authorization header as Bearer sk_live_.... An X-API-Key: sk_live_... header is also accepted as an alternative. Keys are created in the Redpine Connect dashboard under Settings > API Keys.

Keys come in two kinds. A live key (sk_live_...) searches real content and spends credits. A sandbox key (sk_test_...) returns canned results at no cost and never reaches licensed content, so you can build and test an integration before spending anything. Sandbox responses have the same shape as live ones and every result is marked synthetic, so going live is a matter of swapping the key. Check the X-Billing-Mode response header to confirm which you are using.

In: header

Path Parameters

queryId*string

The queryId from a previous search response.

Query Parameters

includeFigures?boolean

Include figure images for results already unlocked. Free, like the rest of this endpoint: it re-delivers content that is already paid for and unlocks nothing. Applies to results that came from POST /api/v1/search/preview; a cached POST /api/v1/search/query response does not retain figures.

Defaultfalse
imageMaxWidth?integer

Maximum image width in pixels.

Range100 <= value <= 1920
Default800
imageMaxHeight?integer

Maximum image height in pixels.

Range100 <= value <= 1080
Default600
imageQuality?integer

JPEG quality for fetched images.

Range1 <= value <= 100
Default75

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/search/results/string"
{  "filterWarnings": null,  "journalMetricExpansions": null,  "latencyMs": 0,  "queryId": "string",  "results": [    {      "collection": null,      "cost": null,      "figureCount": 0,      "id": "string",      "locked": true,      "metadata": null,      "relevance": null,      "text": "string",      "tokens": null    }  ]}
Was this page helpful?