Enriquecimento

Revelar contatos em lote

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.

Revela e-mail e/ou celular para até 20 pessoas (por person_id) numa chamada, 10 em paralelo. Responde em até ~45 s: quem não começou dentro desse tempo volta com status: "skipped" (error: "time_budget", sem cobrança) — mande de novo na próxima chamada.

Para centenas ou milhares de leads use POST /api/v1/enrichment/bulk (uma chamada, CSV no fim).

⚡ Consome créditos por dataset entregue por pessoa (no-data = sem débito). meta.total_credits_used soma o lote.

Rate limit: 50 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/batch' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "both"
}'
02

Corpo da requisição

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

03

Exemplo de retorno

{
  "data": [
    {
      "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
      "status": "found",
      "data": {
        "whatsapp": [
          {
            "numero": "41999998888",
            "whatsapp": true,
            "whatsapp_validated": true,
            "wa_link": "https://wa.me/554199998888",
            "rank": 1,
            "score": 2
          }
        ]
      },
      "credits_used": 0,
      "cached": true
    }
  ],
  "meta": {
    "total_credits_used": 0,
    "summary": {
      "found": 0,
      "not_found": 0,
      "errors": 0
    }
  }
}
{
  "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": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
{
  "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