---
title: "tool si.ask.scrape"
description: "a `ScrapeRequest`: a `ScrapeResult`, the rows as source objects with their evidence spans."
section: reference
address: /reference/tools/si-ask-scrape
contract: 0476e35e6e275db5
---

# tool si.ask.scrape

a `ScrapeRequest`: a `ScrapeResult`, the rows as source objects with their evidence spans.

[figure: Over MCP, si.ask.scrape takes ScrapeRequest and returns a card whose body is ScrapeResult.]

a `ScrapeResult`, the rows as source objects with their evidence spans. The call needs the ask grant at the strategy rung.



| | |
|---|---|
| input | [ScrapeRequest](/concepts/scraperequest) |
| result | a card whose body is [ScrapeResult](/concepts/scraperesult) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/ScrapeResult` |
| HTTP route | [`/v1/ask/scrape`](/reference/ask/scrape) |





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