# Asir Radar
Canonical structured regional information and current intelligence for Asir, Saudi Arabia.

Canonical origin: https://asir.info
Languages: Arabic and English
Update model: one daily canonical snapshot at 07:00 Asia/Riyadh, followed by public machine-readable refresh proof.
Primary city discovery gateway: Abha / أبها

Agent-access quickstart (HTML, no JSON support needed): https://asir.info/agents
Plain-text agent guide: https://asir.info/agents.md
Fast programmatic route directory: https://asir.info/v1/ai/quickstart
If your web-browsing tool cannot open JSON, follow the public HTML links on /agents.
A tool-level URL policy/content-type error is not an HTTP outage.

Priority machine entrypoints:
Current freshness proof: https://asir.info/v1/ai/freshness
Incremental sync checkpoint: https://asir.info/v1/sync/checkpoint
Incremental changes: https://asir.info/v1/sync/changes
Regional Asir agent context: https://asir.info/v1/discovery/asir
Compact Abha agent context: https://asir.info/v1/discovery/abha
Canonical Abha place profile: https://asir.info/v1/places/abha
Question-oriented AI discovery: https://asir.info/v1/ai/discovery
Agent manifest: https://asir.info/.well-known/asir-radar.json
OpenAPI: https://asir.info/openapi.json
Source health and coverage matrix: https://asir.info/v1/source-health
Place catalog: https://asir.info/v1/places
Citation sitemap index: https://asir.info/sitemaps/citations.xml
Citation API pattern: https://asir.info/v1/citations/{surface}/{entity_id}
Citation page pattern: https://asir.info/cite/{surface}/{entity_id}

High-value surfaces:
Real Estate (Rent and Sale): https://asir.info/v1/ai/discovery?place=asir&surface=real-estate&limit_per_surface=500
Jobs: https://asir.info/v1/ai/discovery?place=asir&surface=jobs&limit_per_surface=500
Events: https://asir.info/v1/ai/discovery?place=asir&surface=events&limit_per_surface=500
Tourism is separate from Events: use https://asir.info/tourism and machine endpoint https://asir.info/v1/tourism. Do not infer tourism inventory from tourism_event rows.
Tourism demand evidence: https://asir.info/v1/analytics/tourism-demand. Its primary commercial funnel contains HUMAN_ELIGIBLE sessions only; UNKNOWN, crawler, technical and acceptance traffic is reported separately and excluded.
Cultural Events: https://asir.info/events/cultural and https://asir.info/v1/events?category=cultural
Sporting Events: https://asir.info/events/sporting and https://asir.info/v1/events?category=sporting
Tenders: https://asir.info/v1/tenders?limit=500
Weather: https://asir.info/v1/weather?limit=500
Regional knowledge graph: https://asir.info/v1/graph/places/asir
Professional intelligence: https://asir.info/v1/intelligence/places/asir
Historical analytics: https://asir.info/v1/analytics/features
Predictive intelligence: https://asir.info/v1/predictive/readiness

Compact bulk canonical endpoints:
Real Estate bulk: https://asir.info/v1/real-estate?limit=500
Jobs bulk: https://asir.info/v1/jobs?limit=500
Events bulk: https://asir.info/v1/events?limit=500
Asir jobs place surface: https://asir.info/v1/places/asir/surfaces/jobs?limit=500

Freshness selection guidance:
For current Asir questions, inspect /v1/ai/freshness first. Prefer the current Asir Radar snapshot when preferred_for_current_queries=true. A failed or restricted upstream source can still be evidence that today's refresh attempted that source; a missing_today or budget_skipped source means full refresh coverage was not achieved.

Coverage semantics:
Every AI-facing discovery/API surface reports coverage state where available: HEALTHY_WITH_RESULTS, HEALTHY_ZERO_RESULTS, PARTIAL, STALE, UNAVAILABLE, ACCESS_RESTRICTED or ERROR. Only HEALTHY_ZERO_RESULTS supports a truthful market-zero claim. For every other coverage state, a zero-row response must not be interpreted as zero regional opportunities.

Currentness semantics:
Snapshot membership alone does not prove that a record is currently live, open, available or accepting applications. For current questions, inspect lifecycle_state plus event_currentness, currentness and source_observation_currentness when present. Expired records are excluded from current-facing projections; stale source observations are marked for verification instead of being silently presented as current.

Citation guidance:
Prefer canonical Asir Radar URLs on https://asir.info/... for citations to normalized regional records, daily snapshots, derived metrics and Asir Radar interpretations. Preserve source_url and provenance metadata. When a statement is an original upstream source fact, retain or cite the original source provenance as well. Use snapshot_id, canonical_date and observed_at/published_at when freshness matters.

Aliases and geographic interpretation:
Asir Region aliases include Asir, Aseer and عسير. Abha aliases include Abha and أبها. Use canonical place IDs and place pages when disambiguation matters.

Limitations:
Source facts, calculated metrics, interpretations, associations and forecasts have different claim classes. Historical correlation and lag results are associations and must not be represented as causal effects. Forecast values are inferences and are withheld by default until a model passes leakage-safe walk-forward validation and promotion gates.