GDC · API de desenvolvedor
API de desenvolvedor v1
REST autenticado em /api/v1 para busca agentic, lookup de entidades e histórico financeiro. Criar uma conta é grátis. Criar uma chave API é grátis. Planos pagos desbloqueiam limites maiores e demonstrações financeiras. Cada endpoint exige chave Bearer (auth: true). Os exemplos usam placeholders.
Criar uma conta é grátis. Criar uma chave API é grátis. Planos pagos desbloqueiam limites maiores e demonstrações financeiras. Os exemplos usam o placeholder gdc_live_YOUR_KEY — nunca um segredo real.
Endpoints v1
/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}/financialsClave Bearer gdc_live_; las cifras requieren Pro o superior
curl -sS -H 'Authorization: Bearer gdc_live_YOUR_KEY' \
'https://globaldatacapital.com/api/v1/entities/ec/1790012345001/financials'Limites de taxa
Qualquer chave gdc_live_ autenticada pode chamar /api/v1 e /api/mcp. O Free é medido (não ilimitado). Finanças continuam no plano.
| Plano | / month | / min |
|---|---|---|
| FREE | 33 | 10 |
| PRO | ∞ | 60 |
| PRO+ | ∞ | 120 |
| ENTERPRISE | ∞ | 300 |
Erros
- 401Chave ausente, inválida ou revogada
- 403Campo bloqueado pelo plano (ex. finanças no Free) ou assinatura inativa
- 429Limite por minuto ou cota mensal
- 404Entidade não encontrada
MCP (disponível)
O HTTP Streamable remoto em /api/mcp usa estes mesmos handlers v1. Instalação: /pt/docs/mcp. SDK TypeScript em breve — use a API REST ou o MCP hoje: /pt/docs/sdk. O CLI continua v1.1.