Skip to main content
POST
/
v1
/
watches
/
preview
curl -X POST "https://api.signa.so/v1/watches/preview" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "version": "v1",
      "match": { "owner_id": "own_..." }
    },
    "trial_window_days": 30
  }'

{
  "object": "watch_preview",
  "estimated_match_count": 17,
  "trial_window_days": 30,
  "request_id": "req_..."
}

Documentation Index

Fetch the complete documentation index at: https://docs.signa.so/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Returns the number of trademarks that would have alerted if this query had been a live watch over the last trial_window_days (default 7). Uses the same evaluator code path as creation (VAL-API-011), so the count is a faithful preview — not a separate query engine. Useful before Create Watch to estimate volume and tune score_threshold for similarity watches.

​
Body Parameters

​
query
object
required
Same DSL as Create Watch.
​
trial_window_days
integer
Backtest window (1—365). Default 7.

​
Response

​
object
string
Always "watch_preview".
​
estimated_match_count
integer
Trademarks that would have alerted in the trial window.
​
trial_window_days
integer
Echo of the requested window.
​
request_id
string
Request identifier.
curl -X POST "https://api.signa.so/v1/watches/preview" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "version": "v1",
      "match": { "owner_id": "own_..." }
    },
    "trial_window_days": 30
  }'

{
  "object": "watch_preview",
  "estimated_match_count": 17,
  "trial_window_days": 30,
  "request_id": "req_..."
}