Pessoas
Gerar ou enriquecer pessoas em uma chamada
O preço desta operação para a sua conta fica em Configurações → Planos, já com o valor negociado do seu workspace.
Uma chamada para gerar pessoas (filters na base ou company_cnpjs: pessoas atuais das empresas, ao vivo) OU enriquecer (cpfs, até 100, ou resolve: e-mail, celular, LinkedIn ou person_ref), com os módulos de include[] do catálogo (GET /api/v1/catalog).
CPF só no corpo deste POST — nunca em URL ou query string. O CPF só volta na resposta quando você o enviou, pagou o reverso ou o módulo cpf; nos outros casos o item traz person_ref, uma chave opaca do seu workspace que resolve[] aceita depois.
Preço por item: base (1 por pessoa entregue; pessoa ao vivo em company_cnpjs paga 2 no lugar, sócio não paga base) + reverso (só em acerto, em resolve[] por e-mail, celular ou LinkedIn) + a soma das inclusões entregues, pelo preço do seu workspace. Inclusão sem dado e dado já pago nos últimos 30 dias não cobram. A mesma pessoa repetida na chamada cobra uma vez. celular: até 3 números, só WhatsApp validado, ranqueados; sempre vindos do fluxo de enriquecimento (nunca direto da base). fixos (em celular e cpf) vem sempre como lista vazia: descontinuado.
Teto: max_credits nunca é ultrapassado — a chamada corta itens antes de rodar e devolve meta.truncated: true com meta.cursor.
dry_run: devolve estimate {min,max} e matches_bucket, sem débito e sem rodar inclusões.
⚡ Consome créditos do workspace.
Rate limit: 30 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/people/query' \
-H 'Authorization: Bearer tamz_SUA_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"dry_run": false
}'Corpo da requisição
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Exemplo de retorno
{
"data": [
{
"input": {},
"status": "ok",
"cpf": "string",
"person_ref": "string",
"reverso": {
"status": "delivered",
"data": {}
},
"base": {
"nome": "string",
"cargo": "string",
"empresa": "string",
"idade": 0,
"sexo": "M",
"linkedin_url": "string"
},
"base_status": "delivered",
"includes": {
"property1": {
"status": "delivered",
"data": null
},
"property2": {
"status": "delivered",
"data": null
}
}
}
],
"dry_run": true,
"estimate": {
"min": 0,
"max": 0
},
"matches_bucket": "0",
"meta": {
"mode": "filters",
"returned": 0,
"truncated": true,
"cursor": "string",
"credits": {
"reserved": 0,
"charged": 0,
"released": 0
},
"by_module": {
"property1": {
"items": 0,
"credits": 0
},
"property2": {
"items": 0,
"credits": 0
}
},
"by_unit": {
"base": 0,
"live": 0,
"reverso": 0
}
}
}Respostas e códigos
Response Body
application/json