Sinais
Buscar sinais comerciais
O preço desta operação para a sua conta fica em Configurações → Planos, já com o valor negociado do seu workspace.
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.
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'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"
}
}{
"error": {
"code": "IDEMPOTENCY_CONFLICT"
}
}Respostas e códigos
Response Body
application/json
application/json
application/json