query_signals
Destructive
Query geolocated world event signals with severity and GEOINT scores, filterable by location, date, and category, to identify satellite-collection opportunities.
Instructions
Query geolocated world event signals (Delta Signals: geopolitical, security, disaster, and infrastructure events distilled from global news media, AI-enriched with severity/GEOINT scores and satellite-collection recommendations). Filter by bounding box, date window, and category. Costs 3 token(s) per call, charged to the API key owner's balance.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | No | Bounding box [minLon, minLat, maxLon, maxLat] (WGS84). Omit for worldwide. | |
| date | No | Window end date, YYYY-MM-DD (UTC). Defaults to today. | |
| days | No | Window length in days ending on `date`. Defaults to 1. | |
| sort | No | Result ordering. Omit for the feed's default ranking. "geoint" ranks by the continuous GEOINT collection priority (intelligence.collection_priority) — an imageability gate times tasking value (severity, urgency, information gain, corroboration, escalation, market) — so imageable, decision-relevant events (e.g. a high-severity escalating strike) rise and non-observable news noise sinks. This is NOT the saturated geoint_score. | |
| limit | No | Maximum rows per page. Defaults to 100. | |
| cursor | No | Opaque pagination cursor from a previous response's meta.next_cursor. | |
| markets | No | Restrict to signals AI-tagged as exposing these financial markets via a direct physical/supply channel (informational only, not investment advice). Omit for all. | |
| openData | No | Keep only signals with this open-data sufficiency — free imagery is enough vs commercial tasking recommended (intelligence.open_data_sufficiency). | |
| categories | No | Restrict to these categories. Omit for all. | |
| escalating | No | Keep only signals whose escalation_trend is "escalating". | |
| minSeverity | No | Keep only signals with severity_score >= this (0-10). | |
| createdSince | No | Differential fetch: only signals first enriched at/after this ISO 8601 timestamp. | |
| taskableOnly | No | Keep only signals whose coordinate is search_ready — GEO-READY ONLY: drops country centroids, ADM1 mismatches, reporting-dateline fallbacks and unresolved fixes (intelligence.geo_validation.search_ready). It does NOT imply observable or quality-passed, so not-observable / insufficient-detail / quality-failed signals can still appear. For automated imagery tasking use collectionReadyOnly (or combine with observability:"observable"). | |
| updatedSince | No | Differential fetch: only signals (re)enriched at/after this ISO 8601 timestamp. Ignores the date window. Response signals carry last_updated_at. | |
| observability | No | Keep only signals with this satellite observability — whether a physical mark is imageable at all (intelligence.satellite_observability). | |
| responseFormat | No | Per-signal field detail. "concise" (default) returns the key decision + GEOINT fields (id, date, category, title, location, lat/lng, severity/geoint scores, collection_priority, escalation, market, rs_level/rs_sensor, observability, observability_status, verification_status, geo_status, search_ready, article_count, independent_source_count, information_gain) — cheaper to scan. "detailed" returns the full Signal object (shape per the signals://schema resource). | |
| minInformationGain | No | Keep only signals whose intelligence.expected_information_gain >= this (0-1). | |
| collectionReadyOnly | No | STRICT tasking-candidate filter: search_ready AND observability=observable AND quality.status!=failed AND a concrete collection plan (rs_target + rs_reason present) AND an event coordinate. The safe input set for automated imagery tasking — a superset of every gate taskableOnly alone does not check. | |
| observabilityStatus | No | 3-state observability filter. Unlike `observability` (binary), this exposes `insufficient_detail` — signals where imageability is unknown (no RS enrichment yet, unresolved location, or an Impossible verdict rescued because the event reads kinetic). `not_observable` = a considered "nothing to image"; neither bucket leaks insufficient_detail. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | Query echo, token charge/balance (meta.tokens), and pagination where applicable. | |
| signals | Yes | ||
| summary | No | One-line natural-language summary of the result, ready to relay to a user. |