GDC · Agents and API
Bilingual company search for humans and AI agents
Search by legal name or official country identifier, then cite the source and canonical company record. Public responses never include exact streets, contacts, or financial values.
Plan unlock ladder
Public teasers never include streets, contacts, or financial values. After login, entitlements follow this ladder. Developer API keys themselves are Enterprise-only; response fields still redact by plan.
| Capability | Free | Pro | Pro+ | Enterprise |
|---|---|---|---|---|
| Financials | — | ✓ | ✓ | ✓ |
| Contacts (phone/email/web) | — | — | ✓ | ✓ |
| Export | — | Basic | Basic | Full |
| Developer API keys | — | — | — | ✓ |
Full quotas (export ops, agent spend, API limits):
Data entitlements
| Capability | Free | Pro | Pro+ | Enterprise |
|---|---|---|---|---|
| Financial values | No | Yes | Yes | Yes |
| Contacts (phone / email / web) | No | Yes | Yes | Yes |
| Tax status details | No | Yes | Yes | Yes |
| Legal status details | No | Yes | Yes | Yes |
| SME / MiPyME status | No | Yes | Yes | Yes |
| Credit status details | No | Yes | Yes | Yes |
| Procurement details | No | Yes | Yes | Yes |
| Teams / organizations | No | Yes | Yes | Yes |
| Street address | Exact match only | Full street | Full street | Full street |
| Export columns | None | Full | Full | Full |
| Personal Developer API key (/api/v1, /api/mcp) | Yes (metered) | Yes | Yes | Yes |
| Organization / team API keys | No | Yes | Yes | Yes |
| Directory filter: has person / email / phone | No | Yes | Yes | Yes |
Basic export: Identity, location, and metadata — no financial or contact columns. Full export: All columns including financials and contacts.
Monthly usage quotas
| Meter | Free | Pro | Pro+ | Enterprise |
|---|---|---|---|---|
| Billable directory searches / month | 33 | Unlimited | Unlimited | Unlimited |
| Export operations / month | 0 | Unlimited | Unlimited | Unlimited |
| Companies exported / month | 0 | 10,000 | 10,000 | 10,000 |
| Max companies / export | 0 | 10,000 | 10,000 | 10,000 |
| AI agent spend cap / month (USD) | $0 | $20 | $60 | $200 |
| Developer API requests / month | 33 | Unlimited | Unlimited | Unlimited |
| Developer API requests / minute | 10 | 300 | 300 | 300 |
Agent prompts are unlimited by count; spend is metered in USD (Gemini token cost + margin). Quotas reset monthly — FREE from account creation, paid plans from Stripe billing period.
Developer API (/api/v1)
| Access | Any signed-in account can mint a gdc_live_ key. Paid plans open the full platform and draw one usage wallet at cost × 10. Free stays metered and redacted. |
Free to sign up. Free to create an API key. Paid plans unlock higher limits and financials. Free API usage is metered (not unlimited). Web directory searches are a separate quota. Organization/team keys stay Enterprise.
Human docs: /docs#plans-matrix · Machine: /llms.txt · OpenAPI: /api/v1/openapi.json · Engineering: docs/billing-and-plans.md
Private Developer API (auth: true)
For full agentic search, entity lookup, and financial history with your plan entitlements, use Bearer API keys on /api/v1. Interactive docs with copy-ready curl commands:
Developer API docs → · MCP install → · TypeScript SDK →curl -H "Authorization: Bearer gdc_live_YOUR_KEY" \
"https://globaldatacapital.com/api/v1/search?q=Pichincha&country=EC"Public endpoints
GET https://globaldatacapital.com/api/public/empresas/search?q=Apple&country=USGET https://globaldatacapital.com/api/public/empresas/ec/1790016919001GET https://globaldatacapital.com/api/public/empresas/statsJurisdictions and official sources
- Ecuador: RUC
Ecuador company search powered by SCVS records: find a company by RUC or legal name, verify its identity and location, and see whether financial statements are available.
Superintendencia de Compañías (SCVS) - México: CLEE
Mexico business and establishment search using INEGI DENUE: find establishments by name or CLEE and verify SCIAN activity and official location coverage.
INEGI DENUE — Directorio de establecimientos - United States: CIK
US public-company search using SEC EDGAR identity: find issuers by name or CIK, verify official provenance, and see whether filing-backed financial data is available.
SEC EDGAR — companyfacts (compañías públicas) - Brasil: CNPJ
Brazil public-company search using CVM records: find listed issuers by CNPJ or name, verify official identity, and see whether standardized financial statements are available.
CVM DFP — demonstrações financeiras padronizadas (companhias abertas) - Colombia: NIT
Colombia company search using Supersociedades records: find companies by NIT or legal name, verify identity and city, and see whether IFRS financial data is available.
Supersociedades — estados financieros NIIF (Top empresas) - Argentina: CUIT
Argentina company search using the Registro Nacional de Sociedades: find companies by CUIT or legal name, verify identity and Georef-backed domicile, and see whether CNV financial statements are available for public issuers.
Registro Nacional de Sociedades (RNS) + CNV estados contables de emisoras - Chile: RUT
Chile company search using the SII legal-person nómina: find companies by RUT or legal name, verify region/address when published, and see whether CMF financial statements are available for listed issuers.
SII nómina de personas jurídicas + CMF estados financieros de emisoras
Search playbook
- GET /api/public/empresas/search?q=…&country=… — pass country when known.
- Use bestMatch when present (confidence ≥ 0.85), else the top result; cite legalName + idLabel/identifier and open canonicalUrls.
- For exact address and financials, require login. Financials unlock at Pro; contacts at Pro+; Bearer /api/v1 keys at Enterprise.
Agent rules
- Cite the legal name, identifier, jurisdiction, official source, and refresh date.
- Use the Spanish or English canonical URL matching the user’s language.
- Never infer gated contacts, exact addresses, coordinates, or financial values.