---
title: "List crawl pages"
method: GET
path: "/v1/crawls/{crawlId}/pages"
tags: ["crawls"]
---

# List crawl pages

`GET /v1/crawls/{crawlId}/pages`

## Request

- Base URL: `https://api.olostep.com`
- URL: `https://api.olostep.com/v1/crawls/{crawlId}/pages`
- Auth: HTTP bearer

Retrieves the list of pages processed for a crawl.

## Path parameters

- `crawlId` string, required

## Query parameters

- `cursor` integer
- `limit` integer
- `search_query` string
- `formats` string[]: Deprecated: use GET /v1/retrieve with retrieve_id instead.

## Response `200`

Default Response

- object: A page of crawl pages.
  - `crawl_id` string
  - `object` 'crawl', required
  - `status` string, required
  - `search_query` string, nullable
  - `pages_count` number, required
  - `pages` object[], required
    - `id` string, required
    - `retrieve_id` string, required
    - `url` string, required
    - `is_external` boolean
    - `html_content` string, nullable
    - `markdown_content` string, nullable
  - `metadata` object
    - `external_urls` string[]
    - `failed_urls` string[]
  - `cursor` number

## 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)