Sinais

Buscar sinais comerciais

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.

Cobrança: consome créditos, a cada 10 sinais retornados. Fonte: tabela de operações da API TAMZ, 04/11/2026.

Eventos sobre empresas brasileiras — contratação, nova filial, aporte, recuperação judicial, M&A — vindos do registro cadastral oficial, de quadros de vagas e de notícias.

q roda busca lexical (português) e semântica ao mesmo tempo, fundidas por RRF: contratando gestor de contratos também alcança analista de CLM.

Rate limit: 100 req/min

⚡ Consome créditos por registro retornado.

Idempotência: header x-idempotency-key. A mesma chave com os mesmos parâmetros devolve 200 com replay: true, sem os dados e sem consultar nem cobrar de novo, inclusive enquanto a primeira chamada ainda está rodando (state: "running"). A mesma chave com outros parâmetros devolve 409 IDEMPOTENCY_CONFLICT; chave malformada, 400 INVALID_IDEMPOTENCY_KEY. Toda resposta traz o header X-Operation-Id.

01

Testar ao vivo

Parâmetros

Busca em linguagem natural (lexical + semântica)

Fonte do sinal (valores aceitos no enum). rf_sitesp existe, mas exige o módulo Sinais BR no workspace.

Código do evento. Catálogo fechado de 56 códigos; os mais frequentes são new_company, partner_entry, partner_exit, simples_opt_out, status_closed e cnae_change.

Polaridade. Repetível.

Segmento da empresa do sinal — mesma taxonomia de /api/v1/companies, sem acentuação.

UF (2 letras). Repetível.

Raiz do CNPJ (8 dígitos) — monitorar carteira. Repetível.

Janela em dias

Intensidade mínima 0–100

Confiança mínima do vínculo. Use 0.7 para exigir CNPJ resolvido.

Registros por página

meta.next_cursor da chamada anterior — devolve a página seguinte na mesma ordem. Não monte à mão.

Chave para repetir esta chamada sem cobrar de novo (até 128 caracteres ASCII imprimíveis). Repetida, devolve o replay da operação, sem os dados.

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/signals' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "data": [
    {
      "id": "018e1234-abcd-7000-8000-000000000001",
      "source_code": "jobs",
      "event_type": "hiring_role",
      "polarity": "positive",
      "strength": 62,
      "confidence": 1,
      "cnpj_root": "33000167",
      "company_name": "Petrobras",
      "company_domain": null,
      "title": "Contratando: Gestor de Contratos",
      "summary": "3 vagas do mesmo cargo no mês",
      "source_url": "https://vagas.exemplo.com.br/123",
      "occurred_at": "2026-07-01T00:00:00Z",
      "detected_at": "2026-07-30T12:00:00Z",
      "macro_segment": "Industria & Manufatura",
      "segment": null,
      "uf": "RJ",
      "city": "Rio de Janeiro",
      "rrf_score": 0.031
    }
  ],
  "meta": {
    "limit": 20,
    "total": 1,
    "since_days": 90,
    "semantic": true
  }
}
{
  "error": {
    "code": "INVALID_IDEMPOTENCY_KEY"
  }
}
Empty
Empty
{
  "error": {
    "code": "IDEMPOTENCY_CONFLICT"
  }
}
03

Respostas e códigos

Response Body

application/json

application/json

application/json

Começar grátis