Skip to main content

​
Overview

Structured risk brief for evaluating any city or region as a destination for offices, facilities, or operations. Covers six workstreams: labor/talent, security, infrastructure, connectivity/logistics, regulatory/political, and environmental.

​
Country Code Reference

EndpointParamFormatExample
/api/v1/media-eventslocationFIPS 2-letterUS, UK, GM
/api/v1/conflict-eventscountryFull English nameGermany, Ireland
/api/v1/cameoplus-eventscountryISO-3DEU, IRL, GBR
/media-events requires FIPS location — full country names return 0 results.

​
Workflow

​
Step 1 — Labor & Talent

GET /api/v1/media-events
  ?search={TARGET_CITY} labor market talent shortage hiring layoffs
  &location={FIPS}
  &days=30
  &limit=10

GET /api/v1/media-events
  ?search={TARGET_COUNTRY} strike union labor dispute workers
  &location={FIPS}
  &days=30
  &limit=10

​
Step 2 — Security & Civil Stability

GET /api/v1/conflict-events
  ?country={TARGET_COUNTRY}
  &days=30
  &limit=20

GET /api/v1/conflict-events/summary
  ?country={TARGET_COUNTRY}
  &days=30
  &group_by=event_type

GET /api/v1/media-events
  ?search={TARGET_CITY} protest civil unrest crime safety
  &location={FIPS}
  &days=30
  &limit=10
Near-zero conflict events with low severity IS the positive signal for stable locations.

​
Step 3 — Infrastructure

GET /api/v1/media-events
  ?search={TARGET_COUNTRY} power grid electricity outage shortage capacity
  &location={FIPS}
  &days=30
  &limit=10

GET /api/v1/cameoplus-events
  ?country={ISO3}
  &domain=INFRASTRUCTURE
  &days=30
  &magnitude_min=4.0
  &limit=20

​
Step 4 — Connectivity & Logistics

GET /api/v1/media-events
  ?search={TARGET_CITY} broadband internet connectivity telecommunications
  &location={FIPS}
  &days=30
  &limit=10

GET /api/v1/media-events
  ?search={TARGET_COUNTRY} logistics supply chain import delay customs
  &location={FIPS}
  &days=30
  &limit=10

​
Step 5 — Regulatory & Political

GET /api/v1/cameoplus-events
  ?country={ISO3}
  &domain=POLITICAL
  &days=30
  &magnitude_min=4.0
  &limit=20

GET /api/v1/media-events
  ?search={TARGET_COUNTRY} regulation policy business tax foreign investment
  &location={FIPS}
  &days=30
  &limit=10

​
Step 6 — Environmental & Climate

GET /api/v1/media-events
  ?search={TARGET_COUNTRY} flooding storm weather infrastructure damage climate
  &location={FIPS}
  &days=90
  &limit=10

GET /api/v1/cameoplus-events
  ?country={ISO3}
  &domain=ENVIRONMENT
  &days=90
  &magnitude_min=4.0
  &limit=15
Use 90-day window to capture seasonal patterns.

​
Step 7 — Entity Monitoring

GET /api/v1/entity-geg
  ?entity={INVESTMENT_AGENCY}
  &limit=10

GET /api/v1/entity-geg
  ?entity={CITY_OR_REGIONAL_AUTHORITY}
  &limit=10

​
Output Format

# {TARGET_CITY} Operational Risk Brief — {DATE}

## Executive Summary
[2–3 sentence bottom line]

## Risk Matrix
| Workstream | Risk Level | Key Signal |
|---|---|---|
| Labor/Talent | 🟡 Medium | ... |
| Civil Security | 🟢 Low | ... |
| Power/Infrastructure | 🔴 High | ... |
| Connectivity | 🟢 Low | ... |
| Regulatory | 🟡 Medium | ... |
| Environmental | 🟡 Medium | ... |

## Workstream Details
[One section per workstream with GDELT-sourced evidence]

## Monitor Next 30 Days
## Recommended Actions

​
Tips

  1. Low conflict-events IS the positive signal — report it explicitly
  2. domain=INFRASTRUCTURE in CAMEO+ is the best filter for power/transport events
  3. Use FIPS location + semantic search with city name for city-level coverage
  4. Use 30-day windows for operations; 90-day for environmental/climate