DocumentaciónAgentes y APIDeveloper APICobertura por país

Camella · Agentes y API

Búsqueda bilingüe de empresas para personas y agentes de IA

Busca por razón social o identificador oficial del país y cita la fuente y la ficha canónica. Las respuestas públicas nunca incluyen calles exactas, contactos ni cifras financieras.

Escalera de desbloqueo por plan

Los teasers públicos nunca incluyen calles, contactos ni cifras financieras. Tras el login, los entitlements siguen esta escalera. Las claves de la API de desarrollador son solo Enterprise; los campos de respuesta aún se redactan por plan.

CapacidadFreeProPro+Enterprise
Financieros—✓✓✓
Contactos (tel/email/web)——✓✓
Exportación—BásicaBásicaCompleta
Claves API———✓

Cuotas completas (exportaciones, gasto del agente, límites API):

Permisos de datos

CapacidadFreeProPro+Enterprise
Valores financierosNoSíSíSí
ContactosNoNoSíSí
Detalle tributarioNoNoSíSí
Detalle legalNoNoSíSí
Estado PyME / MiPyMENoNoSíSí
Detalle crediticioNoNoSíSí
Detalle de comprasNoNoSíSí
Equipos / organizacionesNoNoSíSí
DirecciónSolo coincidencia exactaCalle completaCalle completaCalle completa
Columnas de exportaciónNingunaBásicaBásicaCompleta
Claves API (/api/v1)NoNoNoSí
Filtro de directorio: persona / email / teléfonoNoNoNoSí

Exportación básica: Identidad, ubicación y metadatos — sin columnas financieras ni contactos. Exportación completa: Todas las columnas, incluidos financieros y contactos.

Cuotas mensuales

MedidorFreeProPro+Enterprise
Búsquedas de directorio / mes33IlimitadoIlimitadoIlimitado
Operaciones de exportación / mes050200Ilimitado
Empresas exportadas / mes0300100010.000
Máx. empresas / exportación0300100010.000
Tope de gasto del agente IA / mes (USD)$0$20$60$200

Los prompts del agente no tienen límite de cantidad; el gasto se mide en USD (costo de tokens Gemini + margen). Las cuotas se reinician cada mes — FREE desde la creación de cuenta, planes de pago según el ciclo de Stripe.

API de desarrollador (/api/v1)

AccesoPlan Enterprise con suscripción activa o en prueba
Peticiones / mesIlimitado
Peticiones / min300

FREE, Pro y Pro+ no pueden llamar /api/v1 (403). Las 33 búsquedas/mes de Free aplican al directorio web, no a la API de desarrollador.

Docs humanas: /docs#plans-matrix · Máquina: /llms.txt · OpenAPI: /api/v1/openapi.json · Ingeniería: docs/billing-and-plans.md

API privada de desarrollador (auth: true)

Para búsqueda agentic completa, lookup de entidades e historial financiero según tu plan, usa claves Bearer en /api/v1. Documentación interactiva con curl listo para copiar:

Documentación API de desarrollador →
curl -H "Authorization: Bearer cam_live_YOUR_KEY" \
  "https://www.camella.app/api/v1/search?q=Pichincha&country=EC"

Endpoints públicos

GET https://www.camella.app/api/public/empresas/search?q=Apple&country=US
GET https://www.camella.app/api/public/empresas/ec/1790016919001
GET https://www.camella.app/api/public/empresas/stats

OpenAPI 3.1 · llms-full.txt

Jurisdicciones y fuentes oficiales

  • Ecuador: RUC

    Motor de búsqueda empresarial y agente de ventas para Ecuador: consulta compañías por RUC SCVS, estados financieros, ubicación y evidencia oficial.

    Superintendencia de Compañías (SCVS)
  • México: CLEE

    Búsqueda empresarial en México con DENUE: identidad de establecimientos, actividad SCIAN, dirección y coordenadas oficiales para prospección B2B.

    INEGI DENUE — Directorio de establecimientos
  • United States: CIK

    Buscador de empresas para emisores públicos de Estados Unidos: identidad CIK de SEC EDGAR, evidencia financiera y un agente de investigación comercial.

    SEC EDGAR — companyfacts (compañías públicas)
  • Brasil: CNPJ

    Buscador empresarial para Brasil: compañías abiertas de la CVM por CNPJ, disponibilidad de estados financieros y prospección B2B.

    CVM DFP — demonstrações financeiras padronizadas (companhias abertas)
  • Colombia: NIT

    Motor de búsqueda empresarial para Colombia: sociedades Supersociedades por NIT, estados NIIF y agente de ventas para prospección B2B.

    Supersociedades — estados financieros NIIF (Top empresas)
  • Argentina: CUIT

    Motor de búsqueda empresarial para Argentina: sociedades del Registro Nacional de Sociedades por CUIT, domicilios Georef y estados contables CNV de emisoras.

    Registro Nacional de Sociedades (RNS) + CNV estados contables de emisoras

Guía de búsqueda

  1. GET /api/public/empresas/search?q=…&country=… — pasa country cuando lo conozcas.
  2. Usa bestMatch si existe (confidence ≥ 0.85), o el primer resultado; cita legalName + idLabel/identifier y abre canonicalUrls.
  3. Para dirección exacta y financieros, exige login. Financieros en Pro; contactos en Pro+; claves Bearer /api/v1 en Enterprise.

Reglas para agentes

  1. Cita razón social, identificador, jurisdicción, fuente oficial y fecha de actualización.
  2. Usa la URL canónica en español o inglés según el idioma del usuario.
  3. Nunca infieras contactos, direcciones exactas, coordenadas ni cifras financieras bloqueadas.