Enriquecimento
Enriquecer empresa por identificador + datasets
Cobrança por dataset entregue: você paga só o que pede no body e recebe. Nada encontrado = 0.
O preço desta operação para a sua conta fica em Configurações → Planos, já com o valor negociado do seu workspace.
Enriquece uma empresa resolvendo UM identificador (cnpj, cnpj_root, domain OU linkedin_url) e rodando um ou mais datasets (firmografico, saude, frota, processos, processos_detalhe).
Resolução: cnpj resolve por construção (confiança 1); cnpj_root/domain/linkedin_url são resolvidos pela extensão e devolvem meta.confidence (0..1).
Cobrança: só consome créditos por dataset entregue; o que não chega vai para meta.skipped (sem débito) e não aparece em data. Datasets já cacheados nos últimos 30d são servidos do cache (zero crédito) e aparecem em meta.cached.
⚡ Consome créditos do workspace.
Rate limit: 50 req/min.
Testar ao vivo
Autorização
Sua API key, gerada em /developer/api-keys. Gratuita para começar.
Sua requisição
curl -X POST 'https://tamz.ai/api/v1/enrichment/company' \
-H 'Authorization: Bearer tamz_SUA_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"cnpj": "33000167000101",
"cnpj_root": "33000167",
"domain": "petrobras.com.br",
"linkedin_url": "https://www.linkedin.com/company/petrobras"
}'Corpo da requisição
Request Body
application/json
Forneça exatamente UM identificador (cnpj, cnpj_root, domain OU linkedin_url) e ao menos Um dataset.
TypeScript Definitions
Use the request body type in TypeScript.
Exemplo de retorno
{
"data": {
"firmografico": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"cnpj": "33000167000101",
"cnpj_root": "33000167",
"type": "matriz",
"legal_name": "Petroleo Brasileiro S A Petrobras",
"trade_name": "Petrobras - Edise",
"status": "Ativa",
"opening_date": "1953-10-03",
"cnae_main_id": "0600001",
"cnae_main_desc": "Extração de petróleo e gás natural",
"macro_segment": "Industria & Manufatura",
"segment": "Outras Industrias",
"sub_segment": "Industria Diversa",
"natureza_juridica_desc": "Sociedade Anônima Aberta",
"porte_da_empresa": "Demais",
"mei_optante": false,
"capital_social": 205431960490.29,
"people_count": 50874,
"revenue_range": "ACIMA DE 1BI",
"size_range": "500-999",
"veiculos_faixa": "500+",
"website": "petrobras.com.br",
"logo_url": "https://logo.tamz.ai/petrobras.com.br",
"linkedin_url": "https://linkedin.com/company/petrobras",
"linkedin_followers": 2145000,
"address_zip": "20031-912",
"address_street": "Avenida Republica do Chile",
"address_number": "65",
"address_city": "Rio de Janeiro",
"address_state": "RJ",
"address_country": "BR",
"owners": [
{
"person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
"name": "Angelica Laureano",
"cpf": "34791213734",
"idade": 71,
"sexo": "F",
"role": "Diretor",
"equity_pct": 25.5
}
],
"owners_truncated": false
},
"saude": {},
"frota": {
"veiculos_faixa": "500+"
},
"processos": {
"faixa": "1-5",
"faixa_2025": "1-5",
"polo_predominante": "string",
"volume_estimado_faixa": "1-5",
"dados_ate": "2026-08-15"
},
"processos_detalhe": {
"total": 37,
"distribution": {
"by_court_type": {
"property1": 0,
"property2": 0
},
"by_status": {
"property1": 0,
"property2": 0
},
"by_level": {
"property1": 0,
"property2": 0
},
"by_state": {
"property1": 0,
"property2": 0
}
},
"flags": [
"string"
],
"processes": [
{
"court_type": "TRABALHISTA",
"court_name": "TRT2",
"state": "SP",
"status": "ATIVO",
"subject": "string",
"party_polarity": "ACTIVE",
"party_type": "string",
"value": 0,
"capture_date": "2026-05-10"
}
],
"summary": "string"
}
},
"meta": {
"resolved_by": "cnpj",
"company_id": "018e1234-abcd-7000-8000-000000000200",
"cnpj": "33000167000101",
"cnpj_root": "33000167",
"confidence": 1,
"credits_used": 5,
"credits_by_dataset": {
"firmografico": 5
},
"skipped": [
{
"dataset": "firmografico",
"reason": "not_entitled"
}
],
"cached": [
"firmografico"
],
"source": "tamz"
}
}{
"error": {
"code": "INVALID_BODY",
"message": "Body must be valid JSON"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "Insufficient credits",
"available": 2,
"required": 5
}
}{
"error": {
"code": "WORKSPACE_BLOCKED",
"message": "Workspace blocked"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Company not found"
}
}{
"error": {
"code": "AMBIGUOUS_IDENTIFIER",
"message": "Identifier matches more than one company — use cnpj",
"candidates": [
{
"company_id": "018e1234-abcd-7000-8000-000000000200",
"cnpj": "11111111000111",
"label": "Empresa Exemplo SA",
"city": "Rio de Janeiro",
"state": "RJ"
}
]
}
}{
"error": {
"code": "INVALID_PARAMS",
"message": "Invalid parameters",
"issues": [
{
"path": "cnpj",
"message": "Provide exactly one of: cnpj, cnpj_root, domain, linkedin_url"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded",
"retry_after": 42
}
}{
"error": {
"code": "ENRICHMENT_FAILED",
"message": "Enrichment failed"
}
}Respostas e códigos
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json