Global Food Security Intelligence

Real-time aggregation of food safety, trade, and agricultural production data from 5 international government and institutional APIs with composite food security risk scoring (0-100).

Purpose

This Actor analyzes food security and safety by combining data from:

• FDA Food Enforcement - Class I recalls in the last 90 days (public domain)
• USDA FoodData Central - Nutrition database and food records (public domain)
• FAO (Food and Agriculture Organization) - Food security and production indicators (CC-BY 4.0)
• UN Comtrade - Food trade statistics by HS code (CC-BY 3.0 IGO)
• World Bank Open Data - Agricultural production indices (CC-BY 4.0)

Produces a single Food Security Risk Score (0-100) combining:

1. Historical Recall Frequency (Class I last 90 days)
2. Trade/Supply Chain Data (import value and dependencies)
3. Agricultural Production Capacity (production index trend)

Input

Required

• foodCategory (string) — Food category: meat, dairy, produce, grains, oils, sugar, beverages, or coffee
• countryCode (string) — Two-letter ISO country code (e.g., US, KR, DE, FR, JP)

Optional

• hsCode (string) — UN HS Code (2-digit, e.g., 02 for meat). If omitted, auto-mapped from foodCategory.

Output

{
  "query": {
    "foodCategory": "meat",
    "countryCode": "US",
    "hsCode": "02"
  },
  "fdaRecalls": {
    "classICount90d": 12,
    "recentRecalls": [
      {
        "reportDate": "2024-04-05",
        "reason": "Potential contamination",
        "status": "Ongoing"
      }
    ]
  },
  "usdaFood": {
    "recordsFound": 2847,
    "topFoods": [
      {
        "description": "Beef, ground, 73% lean meat / 27% fat, raw",
        "fdcId": 168097
      }
    ]
  },
  "faoIndicators": {
    "dataAvailable": true,
    "recordCount": 156
  },
  "comtradeImports": {
    "totalImportValueUsd": 45000000000,
    "recordCount": 287
  },
  "worldBankAgriculture": {
    "foodProductionIndex": 98.5,
    "year": "2023"
  },
  "foodRiskScore": 35,
  "dataSourcesAvailable": 5,
  "disclaimer": "...",
  "sources": [...],
  "timestamp": "2024-04-08T15:30:00Z"
}

Examples

Meat Safety (United States)

{
  "foodCategory": "meat",
  "countryCode": "US"
}

Dairy Imports (South Korea)

{
  "foodCategory": "dairy",
  "countryCode": "KR"
}

Produce (Germany) with Custom HS Code

{
  "foodCategory": "produce",
  "countryCode": "DE",
  "hsCode": "07"
}

Data Coverage

Country	FDA	USDA	FAO	Comtrade	World Bank
United States	✅	✅	✅	✅	✅
South Korea	⚠️	✅	✅	✅	✅
Germany	⚠️	✅	✅	✅	✅
UK	⚠️	✅	✅	✅	✅
Japan	⚠️	✅	✅	✅	✅
China	⚠️	✅	✅	✅	✅
France	⚠️	✅	✅	✅	✅
Brazil	⚠️	✅	✅	✅	✅

Note: FDA is US-centric (⚠️ limited international data). Other sources provide global coverage.

Pricing

• $0.15 per food security query (Pay-per-Event model)
• Billed only when analysis completes successfully
• No charge if any API call fails
• Minimum 5 API calls per run (parallel, ~8-12 seconds typical)

Risk Score Calculation

Factor	Impact	Notes
Class I Recalls (90d)	+5 to +25	More recalls = higher risk
Import Volume	+5 to +15	Higher imports = supply chain risk
Production Index	+5 to +10	Lower index = production capacity risk
Baseline	50	Neutral starting point

Final score capped at 0-100.

⚠️ Legal Disclaimer

This Actor aggregates publicly available food safety and trade data from:

• US Food and Drug Administration (FDA) Food Enforcement Reports (Public Domain, 17 U.S.C. § 105)
• USDA FoodData Central (Public Domain)
• FAO (Food and Agriculture Organization of the United Nations) - CC-BY 4.0
• UN Comtrade (CC-BY 3.0 IGO)
• The World Bank Open Data (CC-BY 4.0)

NOT food safety, health, or dietary advice. This Actor provides historical data aggregation only.

• Does NOT evaluate food products, brands, or suppliers for current safety
• Does NOT replace official FDA, USDA, or local food safety warnings
• Does NOT forecast future recalls or outbreaks
• Does NOT constitute medical, nutritional, or regulatory advice
• For active food safety emergencies, contact FDA (1-888-INFO-FDA) or local authorities
• Historical recall data does not indicate current product safety status

Attribution:

• "Data source: US Food and Drug Administration (FDA)"
• "Data source: US Department of Agriculture (USDA)"
• "Data source: FAO (CC BY 4.0)"
• "Data source: UN Comtrade (CC BY 3.0 IGO)"
• "Data source: The World Bank (CC BY 4.0)"

Technical Details

• Runtime: Node.js 18+
• Timeout: 120 seconds per query
• Memory: ~256MB per run
• Concurrent API calls: 5 (parallel fetch with 8s timeout each)
• Sources: All public APIs (no authentication keys required except optional BLS token)

API Endpoints

Source	Endpoint	Format
FDA	api.fda.gov/food/enforcement.json	JSON
USDA	api.nal.usda.gov/fdc/v1/foods/search	JSON
FAO	fenixservices.fao.org/faostat/api/v1/	JSON
UN Comtrade	comtradeapi.un.org/public/v1/	JSON
World Bank	api.worldbank.org/v2/country	JSON

All endpoints are free and rate-limit-friendly (no API keys required).

Support

For issues or questions, please contact the developer. Data accuracy is subject to source API availability and update frequency. Last updated: 2026-04-08