---
title: "ScrapeRequest"
description: "arbitrary scraping as data: a scope, an extraction of fields or a schema for the model-assisted reader, the source object the rows become, a resource filter, a held identity and a proxy policy"
section: concepts
address: /concepts/scraperequest
contract: 0476e35e6e275db5
---

# ScrapeRequest

arbitrary scraping as data: a scope, an extraction of fields or a schema for the model-assisted reader, the source object the rows become, a resource filter, a held identity and a proxy policy

[figure: ScrapeRequest is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `template` | `id` | no | an extraction template; any of its parts may be overridden below |
| `scope` | [CrawlScope](/concepts/crawlscope) | no | required when no template |
| `fields` | [FieldSpec](/concepts/fieldspec) | no | declared selectors |
| `schema` | `json` | no | for the model-assisted reader, every value with its evidence span or refused |
| `source_object` | [SourceObject](/concepts/sourceobject) | yes | declared inline for one scrape, or a registered row |
| `mapping` | [Mapping](/concepts/mapping) | no |  |
| `filter` | [ResourceFilter](/concepts/resourcefilter) | yes |  |
| `as_identity` | `id` | no |  |
| `proxy_policy` | [ProxyPolicy](/concepts/proxypolicy) | no |  |
| `credit_cells` | `[id]` | no |  |
| `asked_by` | `text` | no | who asked for the run, as the caller's kind, or the crawler for an address a walk found; the beat takes what a person or the agent asked before the crawler's own discoveries, oldest first within each |



## Routes that use it
- [`/v1/ask/scrape`](/reference/ask/scrape) takes it as input
- [`/v1/act/crawl`](/reference/act/crawl) takes it as input