Pessoas da empresa

Pessoas atuais da empresa (busca ao vivo): Só quem trabalha hoje na empresa, com linkedin_url em toda linha e id aceito em /api/v1/enrichment/person, listas e dossiê. Cobra por pessoa entregue (a mesma pessoa em 30 dias não paga de novo), não por registro. page × limit até 500 — além disso use POST /api/v1/people/discover com cursor. has_email/has_phone/has_linkedin junto com empresa → 400; q/company_state/company_city/company_cnae não se aplicam (aviso em meta.warnings) e fields=rich não traz identidade. Sócios (owners_only=true ou só seniority=Sócio) seguem na base com o preço por registro; Sócio junto com outras senioridades vem na mesma resposta (campo relationship), pelo preço por pessoa. meta.total é estimativa nesse modo.

Lista as pessoas vinculadas à empresa do CNPJ — alias fino de GET /api/v1/people com o CNPJ do path já resolvido para company_cnpj_or_id. Aceita os mesmos filtros, paginação (page, limit, máx. 25), fields e owners_only da busca de pessoas, com a mesma meta (filters_applied + normalized_filters), quota e cobrança (por pessoa entregue; por registro só na listagem de sócios com owners_only=true). CNPJ do path fora do formato de 14 dígitos é 400 invalid_company_identifier; empresa inexistente é 404 company_not_found. Caminho oficial para volume (bulk): o fluxo de listas do MCP — tamz_create_list → tamz_add_to_list (até 500 ids por chamada; linhas já pagas na busca que as revelou) → tamz_list_items (até 200 linhas por página, releitura gratuita). Para audiências acima do teto diário, materialize a lista em vez de paginar este endpoint. tamz_list_filters expõe o vocabulário válido de department/seniority/UF para busca e MCP. Paginação anti-scraping: limit máximo 25 (padrão 10). Em 429 leia retry_after (segundos) e faça backoff exponencial a partir dele (teto 60s); em 402 (VOLUME_QUOTA_EXCEEDED) leia used/cap/reset_at e retome após reset_at — o teto diário é uniforme e não é elevado por cliente.

curl -X GET 'https://tamz.ai/api/v1/companies/33000167000101/people' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'

{
  "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": {
    "page": 1,
    "limit": 10,
    "offset": 0,
    "total": 187069,
    "has_more": true,
    "filters_applied": {
      "department": [
        "Tecnologia"
      ],
      "company_state": [
        "SP"
      ]
    },
    "normalized_filters": {
      "department": [
        "Tecnologia"
      ],
      "company_state": [
        "SP"
      ]
    },
    "credits_used": 0,
    "source": "live",
    "total_is_estimate": true,
    "live": {}
  }
}

{
  "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": "VOLUME_QUOTA_EXCEEDED",
    "message": "Daily row quota reached (15000). Resets at 2026-09-04T00:00:00.000Z.",
    "used": 15000,
    "cap": 15000,
    "reset_at": "2026-09-04T00:00:00.000Z",
    "upgrade_path": "/settings/plans",
    "next_action": "Narrow filters, reduce page size, or continue after reset_at."
  }
}

{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}

{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}