Pro API Guide

The Pro tier gives you on-demand JSON access to the exact same AI-powered supply chain intelligence that powers your daily alerts (disruptions, emerging tech, commodities, prices, historical analysis, and expert forecasts). Perfect for custom dashboards, automation scripts, ERP integrations, or internal tools. Your unique API key was sent in the welcome email after signup.

If you have lost or deleted your API key, contact support from your account's primary email.
You can reach support here: steadfastsupport [at] crossculturegames.com

Using Niches

Any endpoint that ends with the "&niches=" parameter can be tailored to the niches listed after it.
Format: comma-separated values (spaces are okay)
Example: &niches=Automotive,Semiconductors,Energy & Utilities
URL-encoded example: &niches=Automotive,Semiconductors,Energy%20%26%20Utilities
TIP: Omit the parameter to automatically use the niches saved to your account.

Endpoints

Full Daily Alert

The complete intelligence package in one call — disruption news, Emerging Tech Spotlight, commodities with prices & historical trends, plus expert analysis and forecasts. Everything you need for your daily briefing, delivered as clean JSON. The analysis field is already fully-rendered HTML (with styled tables) so you can drop it straight into dashboards or emails.

API Endpoint

GET https://api.crossculturegames.com/api/alerts?api_key=YOUR_KEY

cURL Example

curl "https://api.crossculturegames.com/api/alerts?api_key=YOUR_KEY"

Python Example

import requests
									response = requests.get("https://api.crossculturegames.com/api/alerts",
									params={"api_key": "YOUR_KEY"})
									print(response.json())

Disruption News Only

Top 10 high-impact global disruption stories with detailed English blurbs. Filter by your niches for laser-focused results.

API Endpoint

GET https://api.crossculturegames.com/api/disruptions?api_key=YOUR_KEY&niches=YOUR_NICHES

cURL Example

curl "https://api.crossculturegames.com/api/disruptions?api_key=YOUR_KEY&niches=YOUR_NICHES"

Python Example

import requests
									response = requests.get("https://api.crossculturegames.com/api/disruptions",
									params={"api_key": "YOUR_KEY", "niches": "YOUR_NICHES"})
									print(response.json())

Emerging Tech Spotlight

Curated innovations in AI, robotics, IoT, and smart manufacturing that could reshape your supply chain logistics tomorrow.

API Endpoint

GET https://api.crossculturegames.com/api/tech_news?api_key=YOUR_KEY&niches=YOUR_NICHES

cURL Example

curl "https://api.crossculturegames.com/api/tech_news?api_key=YOUR_KEY&niches=YOUR_NICHES"

Python Example

import requests
									response = requests.get("https://api.crossculturegames.com/api/tech_news",
									params={"api_key": "YOUR_KEY", "niches": "YOUR_NICHES"})
									print(response.json())

Commodity Intelligence

Daily prices, units, reasons for movement, and historical context for up to 10 commodities tied to your news.

API Endpoint

GET https://api.crossculturegames.com/api/commodities?api_key=YOUR_KEY&niches=YOUR_NICHES

cURL Example

curl "https://api.crossculturegames.com/api/commodities?api_key=YOUR_KEY&niches=YOUR_NICHES"

Python Example

import requests
									response = requests.get("https://api.crossculturegames.com/api/commodities",
									params={"api_key": "YOUR_KEY", "niches": "YOUR_NICHES"})
									print(response.json())

Haul Monitor (Freight Estimates)

Air and sea freight rate estimates, plus transit times for major global routes. Updated daily to give you a general idea of the current market.

API Endpoint

GET https://api.crossculturegames.com/api/freight?api_key=YOUR_KEY

cURL Example

curl "https://api.crossculturegames.com/api/freight?api_key=YOUR_KEY"

Python Example

import requests
									response = requests.get("https://api.crossculturegames.com/api/freight",
									params={"api_key": "YOUR_KEY"})
									print(response.json())

Rate Limits

All Intelligence Endpoints: 5 calls per day
Freight Endpoint: 30 calls per day
Limits reset at midnight UTC.

System Health Endpoints

No API key needed. Quick tests:

GET /api/status – service status & version
GET /health or /healthcheck – alive check
GET /ping → returns {"status": "pong"}
GET /version – current version info

Full Sample Response – /api/alerts

Sample JSON Response

									{
									"news": [{"title": "Red Sea attacks force major shipping rerouting...", "blurb": "Detailed English summary of the disruption...", "url": "https://...", "source": "Reuters"}],
									"tech_news": [ ... ],
									"commodities": [{"name": "Steel", "price": 1245.50, "unit": "per metric ton", "reason": "Tariff escalation in Asia directly impacts automotive supply"}],
									"prices": {...},
									"historical": {...},
									"analysis": "<h3 style='color:#FFD900'>Quick Snapshot</h3><p>Expert HTML analysis with styled tables...</p>"
									}

The analysis field is already rendered HTML (tables, headings, lists) — ready to insert directly into any dashboard or email.

Back To home