DocumentationAgents and APIDeveloper APIData coverage by countrySDKMCP

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.

CapabilityFreeProPro+Enterprise
Financials—✓✓✓
Contacts (phone/email/web)——✓✓
Export—BasicBasicFull
Developer API keys———✓

Full quotas (export ops, agent spend, API limits):

Data entitlements

CapabilityFreeProPro+Enterprise
Financial valuesNoYesYesYes
Contacts (phone / email / web)NoYesYesYes
Tax status detailsNoYesYesYes
Legal status detailsNoYesYesYes
SME / MiPyME statusNoYesYesYes
Credit status detailsNoYesYesYes
Procurement detailsNoYesYesYes
Teams / organizationsNoYesYesYes
Street addressExact match onlyFull streetFull streetFull street
Export columnsNoneFullFullFull
Personal Developer API key (/api/v1, /api/mcp)Yes (metered)YesYesYes
Organization / team API keysNoYesYesYes
Directory filter: has person / email / phoneNoYesYesYes

Basic export: Identity, location, and metadata — no financial or contact columns. Full export: All columns including financials and contacts.

Monthly usage quotas

MeterFreeProPro+Enterprise
Billable directory searches / month33UnlimitedUnlimitedUnlimited
Export operations / month0UnlimitedUnlimitedUnlimited
Companies exported / month010,00010,00010,000
Max companies / export010,00010,00010,000
AI agent spend cap / month (USD)$0$20$60$200
Developer API requests / month33UnlimitedUnlimitedUnlimited
Developer API requests / minute10300300300

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)

AccessAny 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=US
GET https://globaldatacapital.com/api/public/empresas/ec/1790016919001
GET https://globaldatacapital.com/api/public/empresas/stats

OpenAPI 3.1 · llms-full.txt

Jurisdictions 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

  1. GET /api/public/empresas/search?q=…&country=… — pass country when known.
  2. Use bestMatch when present (confidence ≥ 0.85), else the top result; cite legalName + idLabel/identifier and open canonicalUrls.
  3. For exact address and financials, require login. Financials unlock at Pro; contacts at Pro+; Bearer /api/v1 keys at Enterprise.

Agent rules

  1. Cite the legal name, identifier, jurisdiction, official source, and refresh date.
  2. Use the Spanish or English canonical URL matching the user’s language.
  3. Never infer gated contacts, exact addresses, coordinates, or financial values.