> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reader.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# CrawlResult

> Return type for crawl() - discovered URLs, optional scrape data, and metadata.

## Top-level shape

```typescript theme={null}
interface CrawlResult {
  urls: CrawlUrl[];
  scraped?: ScrapeResult;
  metadata: CrawlMetadata;
}
```

* `urls` - every discovered page
* `scraped` - present only when `scrape: true` was passed; a full [ScrapeResult](/self-hosted/api-reference/scrape-result)
* `metadata` - aggregate stats for the crawl

## CrawlUrl

```typescript theme={null}
interface CrawlUrl {
  url: string;
  title: string;
  description: string | null;
}
```

One entry per discovered page. Title and description come from the page's `<title>` and meta description tags, extracted during discovery without doing a full scrape.

## CrawlMetadata

```typescript theme={null}
interface CrawlMetadata {
  totalUrls: number;
  maxDepth: number;       // actual max depth reached
  totalDuration: number;  // milliseconds
  seedUrl: string;
}
```

## Example - discovery only

```javascript theme={null}
const result = await reader.crawl({
  url: "https://docs.example.com",
  depth: 2,
  maxPages: 10,
});

// {
//   urls: [
//     { url: "https://docs.example.com/", title: "Docs", description: "..." },
//     { url: "https://docs.example.com/intro", title: "Introduction", description: "..." },
//     ...
//   ],
//   metadata: {
//     totalUrls: 10,
//     maxDepth: 2,
//     totalDuration: 8432,
//     seedUrl: "https://docs.example.com"
//   }
// }
```

## Example - with scraping

```javascript theme={null}
const result = await reader.crawl({
  url: "https://docs.example.com",
  depth: 2,
  maxPages: 10,
  scrape: true,
});

// {
//   urls: [ /* discovered URLs */ ],
//   scraped: {
//     data: [
//       { markdown: "...", metadata: {...} },
//       ...
//     ],
//     batchMetadata: {
//       totalUrls: 10,
//       successfulUrls: 9,
//       failedUrls: 1,
//       ...
//     }
//   },
//   metadata: { ... }
// }
```

Accessing the scraped markdown:

```javascript theme={null}
for (const page of result.scraped?.data ?? []) {
  console.log(`## ${page.metadata.website.title}`);
  console.log(page.markdown);
}
```