# Camella — referência completa para agentes
> Busca trilíngue de empresas com fontes oficiais para pessoas e agentes de IA.

## O que a Camella cobre
- [Ecuador (EC)](https://www.camella.app/pt/empresas/ec): RUC / EC_RUC; 170041 fichas públicas
  - [Fonte](https://www.supercias.gob.ec/): Superintendencia de Compañías (SCVS)
  - Limite: A cobertura foca empresas representadas na fonte SCVS, não todo contribuinte SRI.
- [México (MX)](https://www.camella.app/pt/empresas/mx): CLEE / MX_CLEE; 247500 fichas públicas
  - [Fonte](https://www.inegi.org.mx/app/mapa/denue/): INEGI DENUE — Directorio de establecimientos
  - Limite: Cobre estabelecimentos com coordenadas; não é o cadastro fiscal RFC completo.
- [United States (US)](https://www.camella.app/pt/empresas/us): CIK / US_CIK; 8017 fichas públicas
  - [Fonte](https://www.sec.gov/edgar/search/): SEC EDGAR — companyfacts (compañías públicas)
  - Limite: Não representa o universo completo de empresas privadas dos EUA.
- [Brasil (BR)](https://www.camella.app/pt/empresas/br): CNPJ / BR_CNPJ; 747 fichas públicas
  - [Fonte](https://www.gov.br/cvm/): CVM DFP — demonstrações financeiras padronizadas (companhias abertas)
  - Limite: A cobertura não representa todo o universo CNPJ da Receita Federal.
- [Colombia (CO)](https://www.camella.app/pt/empresas/co): NIT / CO_NIT; 13976 fichas públicas
  - [Fonte](https://www.supersociedades.gov.co/): Supersociedades — estados financieros NIIF (Top empresas)
  - Limite: A cobertura não é o universo completo DIAN ou RUES.
- [Argentina (AR)](https://www.camella.app/pt/empresas/ar): CUIT / AR_CUIT; 100000 fichas públicas
  - [Fonte](https://datos.jus.gob.ar/dataset/registro-nacional-de-sociedades): Registro Nacional de Sociedades (RNS) + CNV estados contables de emisoras
  - Limite: Finanças: CNV/AIF apenas para emissoras em oferta pública.

## API pública (no auth)
- [OpenAPI 3.1](https://www.camella.app/api/public/openapi.json)
- [Search](https://www.camella.app/api/public/empresas/search?q={name_or_id}&country={EC|MX|US|BR|CO|AR}&limit=8)
- [Direct official-ID lookup](https://www.camella.app/api/public/empresas/{country}/{identifier})
- [Coverage](https://www.camella.app/api/public/empresas/stats)

## API privada de desenvolvedor (auth: true)
Bearer `cam_live_…` on every request. [Documentação interativa](https://www.camella.app/pt/docs/developer-api) · [Criar chaves](https://www.camella.app/pt/developer).

- GET `https://www.camella.app/api/v1/search?q={query}&country={EC|MX|US|BR|CO|AR}` — auth: true, agentic search
- GET `https://www.camella.app/api/v1/entities/{country}/{identifier}` — auth: true
- GET `https://www.camella.app/api/v1/entities/{country}/{identifier}/financials` — auth: true, Pro+
- [OpenAPI 3.1](https://www.camella.app/api/v1/openapi.json)

```bash
export CAMELLA_API_KEY=cam_live_YOUR_KEY
curl -H "Authorization: Bearer $CAMELLA_API_KEY" "https://www.camella.app/api/v1/search?q=Pichincha&country=EC"
```

Search envelope includes bestMatch (confidence ≥ 0.85), suggestedCountries, matchHints, and results[].
Pass country when known. Prefer bestMatch or the top result with the highest confidence that matches sector/legal name.

Public fields may include:
- legalName, tradeName, countryCode, countryName, idLabel, scheme, identifier, confidence
- entityType, incorporationDate, status
- classificationScheme, classificationCode, classificationLabel
- source, refreshedAt, financialsAvailable
- city/region or address availability status; never infer an exact street from a teaser
- canonical Spanish and English entity URLs

## Exemplos
- [Corporación Favorita](https://www.camella.app/api/public/empresas/ec/1790016919001)
  - [Página em espanhol](https://www.camella.app/es/empresas/ec/1790016919001)
  - [Página em inglês](https://www.camella.app/en/empresas/ec/1790016919001)
- [Banco do Brasil](https://www.camella.app/api/public/empresas/br/00000000000191)
  - [Página em espanhol](https://www.camella.app/es/empresas/br/00000000000191)
  - [Página em inglês](https://www.camella.app/en/empresas/br/00000000000191)
- [Ecopetrol](https://www.camella.app/api/public/empresas/co/899999068)
  - [Página em espanhol](https://www.camella.app/es/empresas/co/899999068)
  - [Página em inglês](https://www.camella.app/en/empresas/co/899999068)
- [Apple](https://www.camella.app/api/public/empresas/us/0000320193)
  - [Página em espanhol](https://www.camella.app/es/empresas/us/0000320193)
  - [Página em inglês](https://www.camella.app/en/empresas/us/0000320193)
- [Bimbo](https://www.camella.app/api/public/empresas/mx/01005431191000017001002859S8)
  - [Página em espanhol](https://www.camella.app/es/empresas/mx/01005431191000017001002859S8)
  - [Página em inglês](https://www.camella.app/en/empresas/mx/01005431191000017001002859S8)
- [Seguros Galicia](https://www.camella.app/api/public/empresas/ar/30500000127)
  - [Página em espanhol](https://www.camella.app/es/empresas/ar/30500000127)
  - [Página em inglês](https://www.camella.app/en/empresas/ar/30500000127)

## Regras para responder
1. Cite razão social, identificador oficial, jurisdição, fonte e data de atualização quando existirem.
2. Deixe claros os limites: DENUE são estabelecimentos, SEC/CVM cobrem emissores públicos e Supersociedades/SCVS não são cadastros tributários completos.
3. Não invente contatos, ruas exatas, coordenadas, valores financeiros, diretores ou status registral.
4. Se financialsAvailable for true, diga que os dados financeiros podem ser desbloqueados; não infira os valores.
5. Use a URL do idioma do usuário e mantenha o mesmo identificador oficial.

## Documentação para pessoas
- [Documentação de agentes](https://www.camella.app/pt/docs/agents)
- [Documentação da API de desenvolvedor](https://www.camella.app/pt/docs/developer-api)
- [Busca pública](https://www.camella.app/pt/empresas)
- [Sitemap](https://www.camella.app/sitemap.xml)
- [Robots](https://www.camella.app/robots.txt)
- [llms.txt](https://www.camella.app/llms.txt)