Get Search

Retrieve a previously completed search by its ID. Returns whatever was persisted at search time, including any scraped per-link content. Pure idempotent read — no re-scraping, no re-billing.

GET /v1/searches/{search_id}

Get Search

cURL

curl --request GET \
  --url https://api.olostep.com/v1/searches/{search_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "metadata": {},
  "query": "<string>",
  "credits_consumed": 123,
  "result": {
    "json_content": "<string>",
    "json_hosted_url": "<string>",
    "links": [
      {
        "url": "<string>",
        "title": "<string>",
        "description": "<string>",
        "markdown_content": "<string>",
        "html_content": "<string>"
      }
    ],
    "size_exceeded": true,
    "credits_consumed": 123
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer , where is your auth token.

Path Parameters

search_id · string · required

Unique identifier for the search to be retrieved.

Response

200

application/json

Successful response with the search object.

id · string

object · string

created · integer

metadata · object

query · string

credits_consumed · integer

Total credits consumed by the original search request (5 base credits + sum of per-page scrape credits, if scrape_options was used).

result · object

Show child attributes