Camella · SDK

TypeScript SDK (npm i camella)

Official client for /api/v1. Auth is a cam_live_… API key only — Authorization: Bearer plus the apiKey header. Not a website cookie, not a CLI device token, and not the MCP harness unless you paste the same key there yourself.

Install

Free to sign up. Free to create an API key. Paid plans unlock higher limits and financials.

Publish to npm happens after this docs page ships. Until then, install from the monorepo path or wait for the public release.

npm i camella

createCamella

Default baseUrl is https://www.camella.app. The client sends both Authorization: Bearer cam_live_… and apiKey: cam_live_… on every call.

import { createCamella } from 'camella'

const camella = createCamella({
  apiKey: process.env.CAMELLA_API_KEY, // cam_live_…
  // baseUrl: 'https://www.camella.app',
})

const hits = await camella.search('Banco Pichincha', { country: 'EC', limit: 8 })
const entity = await camella.get('EC', '1790016919001')
const financials = await camella.financials('EC', '1790016919001')
const coverage = await camella.coverage()
const checkout = await camella.checkout({ planId: 'ENTERPRISE' })

Methods

SDK	HTTP
`search(q, { country?, limit? })`	GET /api/v1/search
`get(country, id)`	GET /api/v1/entities/{cc}/{id}
`financials(country, id)`	GET /api/v1/entities/{cc}/{id}/financials
`coverage()`	GET /api/public/empresas/stats
`checkout({ planId })`	POST /api/subscriptions/checkout

The SDK does not share TypeScript types with MCP and never calls MCP. 401 / 403 / 404 / 429 stay as typed errors. Plan-gated fields are not unlocked in the client.

Developer API · MCP · Create an API key