GDC · Developer API
Developer API v1
Authenticated REST at /api/v1 for agentic search, entity lookup, and financial history. Free to sign up. Free to create an API key. Paid plans unlock higher limits and financials. Every endpoint requires a Bearer key (auth: true). Examples use placeholders only.
Free to sign up. Free to create an API key. Paid plans unlock higher limits and financials. Examples use the placeholder gdc_live_YOUR_KEY — never a live secret.
v1 endpoints
/api/v1/searchcurl -sS -H 'Authorization: Bearer gdc_live_YOUR_KEY' \
'https://globaldatacapital.com/api/v1/search?q=Pichincha&country=EC&limit=8'/api/v1/entities/{country}/{identifier}curl -sS -H 'Authorization: Bearer gdc_live_YOUR_KEY' \
'https://globaldatacapital.com/api/v1/entities/ec/1790012345001'/api/v1/entities/{country}/{identifier}/financialsBearer gdc_live_ key; financial values require Pro or higher
curl -sS -H 'Authorization: Bearer gdc_live_YOUR_KEY' \
'https://globaldatacapital.com/api/v1/entities/ec/1790012345001/financials'Rate limits
Any signed-in gdc_live_ key can call /api/v1 and /api/mcp. Free is metered (not unlimited). Financials stay plan-gated.
| Tier | / month | / min |
|---|---|---|
| FREE | 33 | 10 |
| PRO | ∞ | 60 |
| PRO+ | ∞ | 120 |
| ENTERPRISE | ∞ | 300 |
Errors
- 401Missing / invalid / revoked API key
- 403Plan-gated field (e.g. financials on Free) or inactive subscription
- 429Rate limit or monthly quota
- 404Entity not found
MCP (shipped)
Remote Streamable HTTP at /api/mcp uses these same v1 handlers. Install docs: /en/docs/mcp. TypeScript SDK coming soon — use the REST API or MCP today: /en/docs/sdk. The CLI remains v1.1.