GDIB
Sign in

Developers

GDIB API

Read-only REST access to the published dataset — platforms, companies and fully-sourced relationships. Keys are issued per partner; request one via the contact on the About page.

Authentication

Every request needs an API key in the Authorization header. Rate limit: 120 requests/minute per key.

curl -H "Authorization: Bearer gdib_YOUR_KEY" \
  "https://www.gdib.ai/api/v1/platforms?domain=air-uav&per_page=10"

Endpoints

  • GET /api/v1/platforms — list; filters q, domain, country (ISO-2), status; paginated (page, per_page ≤ 100).
  • GET /api/v1/platforms/{slug} — full profile including supplier relationships with provenance.
  • GET /api/v1/companies — list; filters q, country, type.
  • GET /api/v1/companies/{slug} — full profile including supply relationships and manufactured platforms.
  • GET /api/v1/relationships — the core table; filters platform, company, category, confidence.

Response shape

{
  "data": [ ... ],
  "meta": { "page": 1, "perPage": 25, "total": 236 },
  "attribution": "Data: GDIB — Global Defence Industrial Base (www.gdib.ai). ..."
}

Every relationship carries sourceUrl, sourceName, confidence (HIGH/MEDIUM/LOW) and verifiedAt — the same provenance shown on the site. Slugs are immutable and safe to store as foreign keys.

For AI assistants (MCP)

GDIB also runs a Model Context Protocol server, so an AI assistant can look things up while it answers. Add https://www.gdib.ai/api/mcp as a custom connector (in Claude: Settings → Connectors → Add custom connector; in ChatGPT: Settings → Connectors). No key needed. Its read-only tools are search_gdib, get_platform_supply_chain, get_company_profile, who_makes, bottleneck_index and country_dependency.

Every fact comes with its source URL and licence, and only facts from openly licensed sources are returned (Wikipedia, Wikidata, government records); each answer links the gdib.ai page where members see the rest. Capped at 60 requests a minute per address.

curl -X POST https://www.gdib.ai/api/mcp -H "Content-Type: application/json"   -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"who_makes","arguments":{"subsystem":"radar","country":"Israel"}}}'

Terms

API use is governed by the Terms of Service: attribute GDIB in anything you publish from it, don't rebuild a competing database from bulk pulls, and re-verify facts against the cited sources for high-stakes use. See also the Sourcing Policy and Methodology.