---
title: "SiteWatch"
description: "a watched identity over a site: its page set and sitemap, its cadence through demand cells, the extraction applied to each page, the conditions that make a change a signal, and the channels told"
section: concepts
address: /concepts/sitewatch
contract: 0476e35e6e275db5
---

# SiteWatch

a watched identity over a site: its page set and sitemap, its cadence through demand cells, the extraction applied to each page, the conditions that make a change a signal, and the channels told

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

| property | value |
|---|---|
| kind | definition |
| scope | follows |
| key | the site, on a brand or a tenant |
| store | postgres |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `site` | `id` | yes | the entity, a company or a brand, or an address |
| `page_patterns` | `[text]` | yes |  |
| `use_sitemap` | `bool` | yes | discovery and last-modified from the sitemap |
| `cadence` | `duration` | yes | arms cells |
| `extraction` | [FieldSpec](/concepts/fieldspec) | no | fields compared version to version |
| `conditions` | [Predicate](/concepts/predicate) | yes | over page changes |
| `channels` | `[id]` | yes | installed connectors with a send-to-channel action |
| `state` | [Readiness](/concepts/readiness) | yes |  |



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