---
title: "ScrapeRun"
description: "one run of an extraction template or of an inline scope: pages walked and denied, rows made, bytes, cost and time, with partial results at block boundaries; a whole site's crawl from its sitemap is one run"
section: concepts
address: /concepts/scraperun
contract: 0476e35e6e275db5
---

# ScrapeRun

one run of an extraction template or of an inline scope: pages walked and denied, rows made, bytes, cost and time, with partial results at block boundaries; a whole site's crawl from its sitemap is one run

[figure: ScrapeRun is a work at follows scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | work |
| scope | follows |
| key | the template's version and the scope's hash |
| store | postgres |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `template` | `id` | yes |  |
| `template_version` | `count` | yes |  |
| `scope_hash` | `hash` | yes |  |
| `pages_walked` | `count` | yes |  |
| `pages_refused` | `count` | yes |  |
| `rows_made` | `count` | yes |  |
| `bytes` | `count` | yes |  |
| `cost` | [Cost](/concepts/cost) | yes |  |
| `failure` | [FailureClass](/concepts/failureclass) | no |  |
| `hops` | [HopStamp](/concepts/hopstamp) | yes |  |
| `request` | [ScrapeRequest](/concepts/scraperequest) | yes | the request the run carries out; the beat runs it from this field alone |
| `pages_found` | `count` | yes | the pages the sitemaps and the seeds gave the frontier |
| `gaps` | [CoverageGap](/concepts/coveragegap) | yes | one gap per page that could not be read, with its reason, and one for the pages past the budget |



## Routes that use it
- [`/v1/act/crawl`](/reference/act/crawl) returns it
- [`/v1/act/set_aside_run`](/reference/act/set_aside_run) returns it