Enriquecimento

Enriquecimento reverso por e-mail pessoal

POST consome créditos

O preço desta operação para a sua conta fica em Configurações → Planos, já com o valor negociado do seu workspace.

Dado um e-mail pessoal (ex.: gmail/hotmail que entra em formulário de marketing), retorna o CPF mais provável e os dados públicos da pessoa para pré-qualificar o lead: identidade (nome, sexo, cidade), empresas onde é sócio (CNPJ, razão social, matriz/filial, total) e cargo/departamento (LinkedIn, quando houver).

🔒 NÃO retorna contato — nada de celular, telefone ou e-mail.

⚡ Consome créditos por HIT. E-mail sem CPF correspondente = grátis (no-data billing). O mesmo e-mail consultado de novo em 30 dias (API ou MCP) = grátis.

Ranking de CPF: quando o e-mail aparece com vários CPFs, o de maior nº de ocorrências é o primário (ranking.confidence); os concorrentes vêm mascarados.

Fallback: e-mail que a base TAMZ não conhece segue automaticamente para uma fonte externa; nesse caso ranking vem null.

Rate limit: 60 req/min

01

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/reverse-email' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "fulano@gmail.com"
}'
02

Corpo da requisição

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

03

Exemplo de retorno

{
  "data": {
    "cpf": "string",
    "identity": {
      "nome": "string",
      "sexo": "string",
      "cidade": "string",
      "uf": "string"
    },
    "ranking": {
      "cpf": "string",
      "confidence": 0,
      "totalRecords": 0,
      "primaryOccurrences": 0,
      "distinctCpfs": 0,
      "alternatives": [
        {
          "cpfMasked": "string",
          "occurrences": 0
        }
      ]
    },
    "companies": {
      "total": 0,
      "items": [
        {
          "cnpj": "string",
          "razaoSocial": "string",
          "nomeFantasia": "string",
          "tipo": "string",
          "cnpjRoot": "string",
          "papel": "string",
          "equityPct": 0
        }
      ]
    },
    "linkedin": {
      "url": "string",
      "role": {
        "jobTitle": "string",
        "department": "string",
        "seniority": "string"
      }
    }
  },
  "meta": {
    "credits_used": 0,
    "found": true,
    "source": "tamz"
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
  }
}
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "required": 10,
    "available": 3,
    "upgrade_path": "/settings/plans",
    "next_action": "Top up credits and retry — zero-result searches are never charged."
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
04

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

Começar grátis