API KeysDocumentação

Crie uma API Key para testar os endpoints ao vivo.

Criar API Key

Esta operação consome créditos do seu workspace por chamada.

get /api/v1/people

Parâmetros

Busca por nome ou cargo

Filtrar por cargo (pode repetir)

Nível de senioridade: `C-Level`, `Diretor`, `Gerente`, `Coordenador`, `Analista`

Departamento: `Comercial`, `Marketing`, `Financeiro`, `RH`, `TI`, `Operações`

Estado (UF) de localização

CNAE da empresa vinculada

Apenas sócios (true/false)

Apenas com email disponível (true/false)

Apenas com LinkedIn disponível (true/false)

Autorização

Informe sua API key gerada em /developer/api-keys

Authorization

bearerAuth
AuthorizationBearer <token>

Informe sua API key gerada em /developer/api-keys

In: header

Query Parameters

q?string

Busca por nome ou cargo

Lengthlength <= 200
job_title?array<string>

Filtrar por cargo (pode repetir)

seniority?array<string>

Nível de senioridade: C-Level, Diretor, Gerente, Coordenador, Analista

department?array<string>

Departamento: Comercial, Marketing, Financeiro, RH, TI, Operações

state?array<string>

Estado (UF) de localização

company_cnae?array<string>

CNAE da empresa vinculada

owners_only?string

Apenas sócios (true/false)

Value in"true" | "false"
has_email?string

Apenas com email disponível (true/false)

Value in"true" | "false"
has_linkedin?string

Apenas com LinkedIn disponível (true/false)

Value in"true" | "false"
page?integer
Default1
Range1 <= value
limit?integer
Default20
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://tamz.ai/api/v1/people?q=CEO+tecnologia&job_title=CEO&job_title=CTO&state=SP"
{
  "data": [
    {
      "id": "018e1234-abcd-7000-8000-000000000042",
      "full_name": "Maria Fernanda Costa",
      "job_title": "CEO",
      "seniority": "C-Level",
      "department": "Diretoria",
      "location_state": "SP",
      "has_email": true,
      "has_phone": false
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "offset": 0,
    "total": 1284,
    "has_more": true
  }
}
{
  "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": "RATE_LIMITED",
    "message": "Rate limit exceeded"
  }
}