Documentación de Camella

Plataforma para buscar, filtrar y analizar empresas en Ecuador, México, Estados Unidos, Brasil, Colombia y Argentina.

¿Qué es Camella?

Camella combina un directorio empresarial multi-país con un asistente de IA conversacional. Diseñado para vendedores, consultores y equipos B2B que necesitan encontrar prospectos, analizar mercados y preparar outreach comercial.

• Empresas: Directorio con filtros, mapa global, perfiles por jurisdicción y búsquedas recientes.
• Agente: Asistente que busca empresas, analiza datos financieros y genera emails personalizados.
• Servicios: Catálogo de tus ofertas para que la IA los use como contexto comercial.

Menú principal: Dashboard → Empresas → Agente → Servicios → Suscripción.

API e integraciones

Camella expone datos de empresas para humanos, agentes de IA y aplicaciones. Resumen en API e integraciones; guías detalladas:

Primeros Pasos

Comienza a usar Camella en menos de 5 minutos.

1. Explora el Directorio

Ve a Empresas (segundo ítem del menú). Usa las pastillas de jurisdicción (Todas, EC, MX, US, BR, CO, AR) para filtrar por país — puedes seleccionar varias a la vez. La vista Split muestra lista y mapa juntos; haz clic en un pin o fila para abrir el inspector y ver el perfil completo.

Recientes guarda tus búsquedas facturables para reanudarlas con un clic.

2. Usa el Agente

Abre Agente para consultas en lenguaje natural sobre empresas, estados financieros y redacción comercial.

3. Ejemplos de Consultas

• "Encuentra empresas de tecnología en Quito con más de 50 empleados"
• "Muéstrame las empresas con mayores ingresos en Guayas"
• "Analiza los estados financieros de Corporación Favorita"
• "Redacta un email para ofrecer mis servicios de consultoría a empresas manufactureras"
• "Encuentra contactos de directivos en empresas de retail"

Directorio Empresas

Directorio multi-país con datos financieros, ubicación y perfiles por jurisdicción.

Información Disponible

Filtros y Jurisdicciones

En Empresas puedes:

• Jurisdicción: Pastillas Todas / EC / MX / US / BR / CO / AR (multi-selección)
• Búsqueda rápida: Por nombre
• Avanzado: Identificador, provincia (EC), rangos financieros y de empleados
• Mapa: Luces geográficas; clic en pin filtra por identificador
• Recientes: Reanuda búsquedas anteriores desde el hub o el dashboard

Perfiles de Empresa

Cada empresa tiene un perfil adaptado a su país:

• Resumen con identidad, ubicación y métricas clave
• Historial financiero multi-año (cuando hay datos)
• Pestaña de ubicaciones con mapa
• Fuentes y auditoría de datos

Motor de Búsqueda Empresarial

Un asistente conversacional que busca empresas, analiza datos y genera contenido comercial.

Capacidades

• Búsqueda de Empresas: Encuentra empresas por ubicación, sector, tamaño, ingresos y más.
• Análisis Financiero: Obtén estados financieros completos, ratios y historial multi-año.
• Búsqueda de Contactos: Encuentra directivos y representantes legales de empresas.
• Generación de Emails: Redacta emails comerciales personalizados usando tus servicios como contexto.
• Búsqueda Web: Busca noticias recientes e información adicional sobre empresas.

Ejemplos de Uso

Para integraciones programáticas: documentación de agentes · API de desarrollador

Catálogo de Servicios

Crea y gestiona tus servicios para que la IA los use como contexto en sus respuestas.

¿Para qué sirve?

Cuando creas servicios en tu catálogo, el Motor de Búsqueda IA los usa automáticamente como contexto. Esto permite que la IA:

• Redacte emails personalizados mencionando tus servicios específicos
• Sugiera empresas relevantes según las industrias objetivo de tus servicios
• Genere propuestas comerciales contextualizadas

Crear un Servicio

Ve a Servicios → Crear producto y completa:

• Nombre y descripción: Qué ofreces
• Precios: Pago único o planes de suscripción
• Industrias objetivo: Sectores a los que te diriges
• Enlaces: Sitio web, redes sociales, documentación
• Contacto público: Información para compartir (opcional)

Compartir Servicios

Puedes hacer tus servicios públicos para compartirlos con empresas:

• Activa el enlace público desde la página de edición
• Se genera una URL única que puedes compartir
• Incluye información de contacto pública (empresa, nombre, email, teléfono)
• Puedes desactivar el enlace en cualquier momento

Búsqueda y Filtros

Filtra empresas por múltiples criterios para encontrar exactamente lo que necesitas.

Filtros Disponibles

También puedes ordenar resultados por ingresos, empleados o completitud de datos, y requerir que las empresas tengan datos de ingresos o empleados para refinar tu búsqueda.

Exportación de Datos

Exporta tus búsquedas a Excel para análisis externo.

Después de buscar empresas en la sección Empresas o usando el Motor de Búsqueda IA, puedes exportar los resultados a un archivo Excel. Las cuotas dependen de tu plan: operaciones de exportación, empresas exportadas al mes y máximo por archivo.

Alcance por plan

• Free: sin exportación.
• Pro / Pro+: exportación básica — identidad, ubicación y metadatos (sin columnas financieras ni contactos).
• Enterprise: exportación completa — todas las columnas, incluidos financieros y contactos.

Cuotas mensuales

Consulta el uso en tiempo real en Uso o Facturación.

Planes y Suscripción

Matriz canónica de precios, permisos de datos y cuotas mensuales.

Camella ofrece cuatro planes de producto — Free, Pro, Pro+ y Enterprise — más un nivel público anónimo en /empresas (teaser sin login). Compara precios en Precios y gestiona tu suscripción en Facturación.

Matriz de planes y uso

Facturación y demotion

• Los planes de pago requieren suscripción activa o en prueba. Si el pago falla dos veces seguidas, la cuenta vuelve a Free y se revocan las claves API.
• Facturación anual con −20% disponible para Pro+ y Enterprise; las cuotas siguen siendo mensuales.
• Los valores en vivo se leen de subscription_plans; el fallback de código está en lib/plans-defaults.ts.

API e integraciones

Datos de empresas para humanos, agentes de IA y aplicaciones que integran Camella.

API pública (agentes)

Endpoints sin autenticación para descubrir empresas por nombre o identificador oficial (RUC, CLEE, CIK, CNPJ, NIT, CUIT). Las respuestas son teasers: sin calles exactas, contactos ni cifras financieras.

• GET /api/public/empresas/search — búsqueda con bestMatch y matchHints
• GET /api/public/empresas/{country}/{identifier} — lookup directo
• GET /api/public/openapi.json — OpenAPI 3.1
• GET /llms.txt — guía para agentes de IA

Guía completa: documentación de agentes

API de desarrollador (v1)

API autenticada con claves Bearer cam_live_… (auth: true en todos los endpoints v1). Incluye búsqueda agentic, lookup de entidades e historial financiero según tu plan.

• GET /api/v1/search — búsqueda agentic multi-país
• GET /api/v1/entities/{country}/{identifier} — lookup
• GET /api/v1/entities/…/financials — finanzas (requiere clave Enterprise; valores según plan)
• GET /api/v1/openapi.json — OpenAPI 3.1

Documentación interactiva (curl, Node.js, Python) y gestión de claves: API de desarrollador · consola de desarrollador

Configuración

Gestiona tu perfil, información de empresa y suscripción.

Información Personal

Actualiza tus datos personales:

• Nombre y apellido
• Teléfono de contacto
• Cargo o posición en tu empresa

Tu correo electrónico se utiliza como identificador único y no puede ser modificado desde esta pantalla.

Información de Empresa

Proporciona detalles sobre la empresa que representas:

• Nombre de la empresa
• RUC de la empresa (13 dígitos)

Suscripción

Gestiona tu suscripción a Camella:

• Estado del Plan: Visualiza tu plan actual y límites de uso
• Portal de Facturación: Accede al portal seguro de Stripe para actualizar tu método de pago y ver facturas (disponible solo para planes de pago)
• Cambiar Plan: Explora otros planes y actualiza tu suscripción desde Precios