Pessoas

Pessoa por nome + domínio (0% FP)

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.

Resolve a empresa dona do domínio do e-mail e casa o nome SÓ entre quem já tem vínculo com ela (sócios + scraped) — nunca infere por nome nacional. Match único → pessoa + flags de contato (sem PII crua) + match_score.

⚡ Consome créditos por pessoa resolvida com match; no_match/domain_unresolved/ambiguous são gratuitos. Com reveal_phone=true, o celular é cobrado à parte (no-data = sem débito).

Rate limit: 50 req/min

⚡ Consome créditos por pessoa resolvida com match.

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/find-person-by-domain' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "full_name": "Maria Fernanda Costa",
  "email_or_domain": "maria@totvs.com.br",
  "reveal_phone": false
}'
02

Corpo da requisição

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

03

Exemplo de retorno

{
  "data": {
    "person": {
      "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
      "name": "string",
      "title": "string",
      "seniority": "string",
      "relationship_type": "string",
      "company": "string",
      "company_cnpj": "string",
      "has_email": true,
      "has_phone": true,
      "has_linkedin": true,
      "has_cpf": true
    },
    "phone": {
      "phone": "41999998888",
      "phones": [
        {
          "number": "41999998888",
          "whatsapp": true,
          "whatsappChecked": true,
          "jid": "string",
          "numero": "41999998888",
          "whatsapp_validated": true,
          "wa_link": "https://wa.me/554199998888",
          "rank": 1
        }
      ]
    }
  },
  "meta": {
    "match": "matched",
    "domain": "string",
    "match_score": 0,
    "credits_used": 0,
    "credits_remaining": 0,
    "source": "database"
  }
}
{
  "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
  }
}
04

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

application/json

Começar grátis