KEkernel
Search

Retrieve a search

Changed on

Returns the retained search resource exactly as it was returned by POST /search: results, attempts, warnings, usage, and expires_at. No provider is called and nothing is billed. Use it to look up a search by ID for debugging, cost review, or to recover result IDs before calling the contents endpoint. Inline content fetched at search time is included; content fetched later through the contents endpoint is not merged in. Missing, expired, or inaccessible searches return 404.

get/search/{id}

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/search/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

Search resource ID returned by POST /search.

Response

The retained search.

answerstring

Provider-generated answer when requested (e.g. via Tavily include_answer or Perplexity). Preserved independently of include_raw.

expires_atstring date-time required

Expiration of result IDs for deferred retrieval. Results expire 24 hours after search completion.

idstring required

Search resource ID. Request tracing uses X-Request-Id.

providerstring required

Concrete serving provider, never auto or fallback.

querystring required

Echo of the query. Native multi-query inputs are visible in the selected strategy target and the optional raw response.

rawunknown

Example response

{
  "id": "srch_abc123",
  "results": [
    {
      "id": "srchr_def456"
    }
  ]
}

Changes