Pessoas

Lookup pessoa por email, telefone ou LinkedIn

GET 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.

Identifique uma pessoa informando email, telefone ou URL do LinkedIn. Retorna perfil completo + empresa vinculada.

Caso de uso: você tem o email de um prospect — passe o email e receba cargo, empresa, segmento e mais.

A busca passa pelas bases de contato do TAMZ (telefones e e-mails ligados por CPF), não apenas pelo cadastro da pessoa.

Quando o identificador pertence a mais de uma pessoa — e-mail corporativo compartilhado, telefone de recepção — a resposta é 409 AMBIGUOUS_IDENTIFIER e nada é cobrado: preferimos não responder a devolver a pessoa errada.

⚡ Consome créditos (cache de 24h).

Rate limit: 60 req/min

01

Testar ao vivo

Parâmetros

Email da pessoa, profissional ou pessoal (use apenas um identificador por vez)

Telefone com DDD, com ou sem DDI e máscara — as formas de 10 e 11 dígitos são equivalentes (use apenas um identificador por vez)

URL do perfil LinkedIn — aceita com ou sem www e com ou sem barra final (use apenas um identificador por vez)

Autorização

Sua API key, gerada em /developer/api-keys. Gratuita para começar.

Sua requisição

curl -X GET 'https://tamz.ai/api/v1/person' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "Izadora Lima",
    "cpf": "01683398114",
    "idade": 41,
    "sexo": "F",
    "job_title": "Commercial Executive Director",
    "seniority": "C-Level",
    "department": "Vendas",
    "linkedin_url": "https://www.linkedin.com/in/izadora-lima",
    "pic_url": "https://media.licdn.com/dms/image/v2/…",
    "location_city": "sao paulo",
    "location_state": "SP",
    "has_email": true,
    "has_phone": false,
    "contact_path": true,
    "company": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "cnpj": "84453844000188",
      "name": "Tellerina Comercio De Presentes S.A.",
      "segment": "Outras Industrias",
      "porte": "Demais",
      "revenue_range": "R$100M+",
      "state": "SP"
    }
  },
  "meta": {
    "credits_used": 10,
    "source": "database",
    "cached": false
  }
}
{
  "error": {
    "code": "MISSING_IDENTIFIER",
    "message": "Provide exactly one of: email, phone, linkedin"
  }
}
{
  "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": "NOT_FOUND",
    "message": "Company not found"
  }
}
{
  "error": {
    "code": "AMBIGUOUS_IDENTIFIER",
    "message": "This identifier is linked to more than one person — use a more specific one"
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
03

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Começar grátis