Global Refugee Migration Tracker

Real-time aggregation of refugee and migration flow data from 4 international sources with composite migration pressure scoring (0-100).

Purpose

This Actor analyzes refugee and migration patterns for any country by combining data from:

• US State Department - Travel Advisory Levels (1-4) indicating country risk
• World Bank - Refugee population counts and international migrant stock percentages
• The GDELT Project - Real-time news mentions of refugees/migration (30-day window)
• Our World in Data - Historical refugee population origin statistics

Produces a single Migration Pressure Score (0-100) combining:

1. US State Dept Level (40% weight)
2. Refugee Population (20% weight)
3. International Migrant Stock % (20% weight)
4. GDELT News Mentions (15% weight)
5. Our World in Data Refugee Population (5% weight)

Input

Required

• countryCode (string) — Two-letter ISO country code (e.g., UA for Ukraine, SY for Syria, AF for Afghanistan)

Output

{
  "countryCode": "UA",
  "countryName": "Ukraine",
  "migrationPressureScore": 87.5,
  "stateDeptLevel": 4,
  "refugeePopulation": 5800000,
  "internationalMigrantStock": 8.2,
  "gdeltNewsMentions": 18,
  "ourWorldInDataRefugeePopulation": 6200000,
  "dataAvailability": {
    "stateDept": true,
    "worldBank": true,
    "gdelt": true,
    "owid": true
  },
  "successfulSourceCount": 4,
  "sources": [...],
  "disclaimer": "...",
  "timestamp": "2026-04-09T12:30:00Z"
}

Examples

Basic Usage - Ukraine

{
  "countryCode": "UA"
}

Syria Conflict Analysis

{
  "countryCode": "SY"
}

Afghanistan Migration Patterns

{
  "countryCode": "AF"
}

Data Coverage

Country	State Dept	World Bank	GDELT	OWiD
Ukraine	✅	✅	✅	✅
Syria	✅	✅	✅	✅
Afghanistan	✅	✅	✅	✅
South Sudan	✅	✅	✅	✅
Venezuela	✅	✅	✅	✅
Myanmar	✅	✅	✅	✅
Somalia	✅	✅	✅	✅
Yemen	✅	✅	✅	✅

Pricing

• $0.17 per country analysis (Pay-per-Event model)
• Billed only when analysis completes successfully
• No charge if all API sources fail

⚠️ Legal Disclaimer

This Actor aggregates publicly available migration and refugee data from:

• US State Department Travel Advisories (Public Domain)
• The World Bank Open Data (CC-BY 4.0)
• The GDELT Project (CC-BY 4.0)
• Our World in Data (CC-BY 4.0)

NOT immigration, asylum, legal, or humanitarian advice. This Actor provides historical data aggregation and statistical analysis only.

• Does NOT recommend migration, asylum, or relocation decisions
• Does NOT guarantee data accuracy or completeness
• Does NOT constitute legal, immigration, or humanitarian guidance
• Users are responsible for verifying data with original sources
• Does NOT replace UNHCR, IOM, or official government refugee assessments
• Historical data does not predict future migration patterns

All source data is redistributed under the original license terms with attribution. Data retrieved in real-time; not cached or stored by this Actor.

Attribution:

• "Data source: US State Department (Public Domain)"
• "Data source: The World Bank (CC BY 4.0)"
• "Data source: The GDELT Project (CC BY 4.0)"
• "Data source: Our World in Data (CC BY 4.0)"

Technical Details

• Runtime: Node.js 18+
• Timeout: 120 seconds per country
• Memory: ~128MB per run
• Concurrent API calls: 4 (parallel fetch)
• Source availability: 4 international government/institutional APIs

Support

For issues or questions, please contact the developer. Data accuracy is subject to source API availability and update frequency.

---

Last updated: 2026-04-09