Camella · Agents and API
Bilingual company search for humans and AI agents
Search by legal name or official country identifier, then cite the source and canonical company record. Public responses never include exact streets, contacts, or financial values.
Plan unlock ladder
Public teasers never include streets, contacts, or financial values. After login, entitlements follow this ladder. Developer API keys themselves are Enterprise-only; response fields still redact by plan.
| Capability | Free | Pro | Pro+ | Enterprise |
|---|---|---|---|---|
| Financials | — | ✓ | ✓ | ✓ |
| Contacts (phone/email/web) | — | — | ✓ | ✓ |
| Export | — | Basic | Basic | Full |
| Developer API keys | — | — | — | ✓ |
Full quotas (export ops, agent spend, API limits):
Data entitlements
| Capability | Free | Pro | Pro+ | Enterprise |
|---|---|---|---|---|
| Financial values | No | Yes | Yes | Yes |
| Contacts (phone / email / web) | No | No | Yes | Yes |
| Tax status details | No | No | Yes | Yes |
| Legal status details | No | No | Yes | Yes |
| SME / MiPyME status | No | No | Yes | Yes |
| Credit status details | No | No | Yes | Yes |
| Procurement details | No | No | Yes | Yes |
| Teams / organizations | No | No | Yes | Yes |
| Street address | Exact match only | Full street | Full street | Full street |
| Export columns | None | Basic | Basic | Full |
| Developer API keys (/api/v1) | No | No | No | Yes |
| Directory filter: has person / email / phone | No | No | No | Yes |
Basic export: Identity, location, and metadata — no financial or contact columns. Full export: All columns including financials and contacts.
Monthly usage quotas
| Meter | Free | Pro | Pro+ | Enterprise |
|---|---|---|---|---|
| Billable directory searches / month | 33 | Unlimited | Unlimited | Unlimited |
| Export operations / month | 0 | 50 | 200 | Unlimited |
| Companies exported / month | 0 | 300 | 1,000 | 10,000 |
| Max companies / export | 0 | 300 | 1,000 | 10,000 |
| AI agent spend cap / month (USD) | $0 | $20 | $60 | $200 |
Agent prompts are unlimited by count; spend is metered in USD (Gemini token cost + margin). Quotas reset monthly — FREE from account creation, paid plans from Stripe billing period.
Developer API (/api/v1)
| Access | Enterprise plan with active or trialing subscription |
| Requests / month | Unlimited |
| Requests / minute | 300 |
FREE, Pro, and Pro+ cannot call /api/v1 (403). The 33 searches/month on Free apply to the web directory, not the developer API.
Human docs: /docs#plans-matrix · Machine: /llms.txt · OpenAPI: /api/v1/openapi.json · Engineering: docs/billing-and-plans.md
Private Developer API (auth: true)
For full agentic search, entity lookup, and financial history with your plan entitlements, use Bearer API keys on /api/v1. Interactive docs with copy-ready curl commands:
Developer API docs →curl -H "Authorization: Bearer cam_live_YOUR_KEY" \
"https://www.camella.app/api/v1/search?q=Pichincha&country=EC"Public endpoints
GET https://www.camella.app/api/public/empresas/search?q=Apple&country=USGET https://www.camella.app/api/public/empresas/ec/1790016919001GET https://www.camella.app/api/public/empresas/statsJurisdictions and official sources
- Ecuador: RUC
Ecuador company search powered by SCVS records: find a company by RUC or legal name, verify its identity and location, and see whether financial statements are available.
Superintendencia de Compañías (SCVS) - México: CLEE
Mexico business and establishment search using INEGI DENUE: find establishments by name or CLEE and verify SCIAN activity and official location coverage.
INEGI DENUE — Directorio de establecimientos - United States: CIK
US public-company search using SEC EDGAR identity: find issuers by name or CIK, verify official provenance, and see whether filing-backed financial data is available.
SEC EDGAR — companyfacts (compañías públicas) - Brasil: CNPJ
Brazil public-company search using CVM records: find listed issuers by CNPJ or name, verify official identity, and see whether standardized financial statements are available.
CVM DFP — demonstrações financeiras padronizadas (companhias abertas) - Colombia: NIT
Colombia company search using Supersociedades records: find companies by NIT or legal name, verify identity and city, and see whether IFRS financial data is available.
Supersociedades — estados financieros NIIF (Top empresas) - Argentina: CUIT
Argentina company search using the Registro Nacional de Sociedades: find companies by CUIT or legal name, verify identity and Georef-backed domicile, and see whether CNV financial statements are available for public issuers.
Registro Nacional de Sociedades (RNS) + CNV estados contables de emisoras
Search playbook
- GET /api/public/empresas/search?q=…&country=… — pass country when known.
- Use bestMatch when present (confidence ≥ 0.85), else the top result; cite legalName + idLabel/identifier and open canonicalUrls.
- For exact address and financials, require login. Financials unlock at Pro; contacts at Pro+; Bearer /api/v1 keys at Enterprise.
Agent rules
- Cite the legal name, identifier, jurisdiction, official source, and refresh date.
- Use the Spanish or English canonical URL matching the user’s language.
- Never infer gated contacts, exact addresses, coordinates, or financial values.