# Camella — referencia completa para agentes
> Buscador bilingüe de empresas con fuentes oficiales para personas y agentes de IA.

## Qué cubre Camella
- [Ecuador (EC)](https://www.camella.app/es/empresas/ec): RUC / EC_RUC; 170041 fichas públicas
  - [Fuente](https://www.supercias.gob.ec/): Superintendencia de Compañías (SCVS)
  - Límite: Cobertura de producto enfocada en sociedades activas con filing reciente.
- [México (MX)](https://www.camella.app/es/empresas/mx): CLEE / MX_CLEE; 247500 fichas públicas
  - [Fuente](https://www.inegi.org.mx/app/mapa/denue/): INEGI DENUE — Directorio de establecimientos
  - Límite: Cubre establecimientos con coordenadas; no es el padrón fiscal completo RFC.
- [United States (US)](https://www.camella.app/es/empresas/us): CIK / US_CIK; 8017 fichas públicas
  - [Fuente](https://www.sec.gov/edgar/search/): SEC EDGAR — companyfacts (compañías públicas)
  - Límite: No representa el universo completo de empresas privadas de Estados Unidos.
- [Brasil (BR)](https://www.camella.app/es/empresas/br): CNPJ / BR_CNPJ; 747 fichas públicas
  - [Fuente](https://www.gov.br/cvm/): CVM DFP — demonstrações financeiras padronizadas (companhias abertas)
  - Límite: No representa el universo completo del CNPJ nacional de Receita Federal.
- [Colombia (CO)](https://www.camella.app/es/empresas/co): NIT / CO_NIT; 13976 fichas públicas
  - [Fuente](https://www.supersociedades.gov.co/): Supersociedades — estados financieros NIIF (Top empresas)
  - Límite: Precisión de ubicación a nivel ciudad por diseño en el dump abierto.
- [Argentina (AR)](https://www.camella.app/es/empresas/ar): CUIT / AR_CUIT; 100000 fichas públicas
  - [Fuente](https://datos.jus.gob.ar/dataset/registro-nacional-de-sociedades): Registro Nacional de Sociedades (RNS) + CNV estados contables de emisoras
  - Límite: Finanzas: CNV/AIF solo para emisoras en oferta pública (no todo el padrón).

## 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 desarrollador (auth: true)
Bearer `cam_live_…` on every request. [Documentación interactiva](https://www.camella.app/es/docs/developer-api) · [Crear claves](https://www.camella.app/es/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

## Ejemplos
- [Corporación Favorita](https://www.camella.app/api/public/empresas/ec/1790016919001)
  - [Spanish page](https://www.camella.app/es/empresas/ec/1790016919001)
  - [English page](https://www.camella.app/en/empresas/ec/1790016919001)
- [Banco do Brasil](https://www.camella.app/api/public/empresas/br/00000000000191)
  - [Spanish page](https://www.camella.app/es/empresas/br/00000000000191)
  - [English page](https://www.camella.app/en/empresas/br/00000000000191)
- [Ecopetrol](https://www.camella.app/api/public/empresas/co/899999068)
  - [Spanish page](https://www.camella.app/es/empresas/co/899999068)
  - [English page](https://www.camella.app/en/empresas/co/899999068)
- [Apple](https://www.camella.app/api/public/empresas/us/0000320193)
  - [Spanish page](https://www.camella.app/es/empresas/us/0000320193)
  - [English page](https://www.camella.app/en/empresas/us/0000320193)
- [Bimbo](https://www.camella.app/api/public/empresas/mx/01005431191000017001002859S8)
  - [Spanish page](https://www.camella.app/es/empresas/mx/01005431191000017001002859S8)
  - [English page](https://www.camella.app/en/empresas/mx/01005431191000017001002859S8)
- [Seguros Galicia](https://www.camella.app/api/public/empresas/ar/30500000127)
  - [Spanish page](https://www.camella.app/es/empresas/ar/30500000127)
  - [English page](https://www.camella.app/en/empresas/ar/30500000127)

## Reglas para responder
1. Cita razón social, identificador oficial, jurisdicción, fuente y fecha de actualización cuando existan.
2. Aclara los límites: DENUE son establecimientos, SEC/CVM cubren emisores públicos y Supersociedades/SCVS no son padrones tributarios completos.
3. No inventes contactos, calles exactas, coordenadas, cifras financieras, directivos ni estado registral.
4. Si financialsAvailable es true, indica que se pueden desbloquear datos financieros; no infieras sus valores.
5. Usa la URL del idioma del usuario y conserva el mismo identificador oficial.

## Documentación para personas
- [Documentación de agentes](https://www.camella.app/es/docs/agents)
- [Documentación API de desarrollador](https://www.camella.app/es/docs/developer-api)
- [Búsqueda pública](https://www.camella.app/es/empresas)
- [Sitemap](https://www.camella.app/sitemap.xml)
- [Robots](https://www.camella.app/robots.txt)
- [llms.txt](https://www.camella.app/llms.txt)