---
title: "Retrieve content"
method: GET
path: "/v1/retrieve"
tags: ["retrieve"]
---

# Retrieve content

`GET /v1/retrieve`

## Request

- Base URL: `https://api.olostep.com`
- URL: `https://api.olostep.com/v1/retrieve`
- Auth: HTTP bearer

Retrieve previously scraped content by retrieve_id.

## Query parameters

- `retrieve_id` string, required: The retrieve_id returned by a scrape.
- `formats` union: Comma-separated formats, a JSON array, or a repeated query key.
  - string
  - string[]

## Response `200`

Default Response

- object: Retrieved content.
  - `markdown_content` string, nullable
  - `html_content` string, nullable
  - `json_content` string, nullable
  - `json_url` string, nullable: Public URL of an ntwrk_ payload.
  - `network_calls` object[], nullable
  - `screenshot_hosted_url` string, nullable
  - `success` true
  - `html_hosted_url` string, nullable: S3 bucket URL of html. Expires in 7 days.
  - `markdown_hosted_url` string, nullable: S3 bucket URL of markdown. Expires in 7 days.
  - `json_hosted_url` string, nullable: S3 bucket URL of json. Expires in 7 days.
  - `size_exceeded` boolean: True when content exceeds the 6MB limit — use the hosted URLs instead.

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: Default Response
- `502`: Default Response

---

[API](https://skmtc.dev/olostep/apis/olostep-api.md) · [All operations](https://skmtc.dev/olostep/apis/olostep-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olostep/apis/olostep-api/revisions/13c766ab100c?raw)