Brazilian Company Signals

Aggregates public Brazilian company data into a single API call — registry + open job postings + public procurement + AI commercial report — perfect for B2B sales prospecting, lead qualification, due diligence, and market research.

What it does

Given a CNPJ (Brazilian company tax ID), returns one structured JSON with:

• Cadastral (minhareceita.org + Receita Federal fallback): legal name, trade name, status, capital, CNAE (primary + secondary), address, phones, email, partners with age range and masked CPF, tax regime history (2016-2024)
• Vagas / Job postings (Gupy): open positions published by the company — a strong signal of active hiring and team expansion
• Licitações / Public procurement (PNCP, opt-in): government contracts where the company appears as the purchasing entity — relevant when prospecting the public sector
• Aggregated intelligence: commercial tier (LOW / MEDIUM / HIGH / VERY_HIGH), company age and category, activity score, risk flags
• AI commercial report (optional): 140-200 word inferential analysis in Portuguese with tone that adapts to the company profile — bring your own OpenAI key

Why use it

Brazil has 50M+ registered companies, but the public data is spread across multiple government APIs with different formats, rate limits, and quirks. This actor does the unification work for you — zero auth on public sources, zero ToS risk, structured JSON ready to pipe into any CRM.

Use cases

• B2B SDRs: qualify CNPJs in your pipeline before reaching out. Open job postings = hiring timing. Commercial tier = prioritization.
• Due diligence: verify cadastral status, tax regime history, and partners in seconds.
• Market research: enrich lists of CNPJs with real activity signals, not just registry data.
• CRM enrichment: pipe via n8n / Zapier / Make into HubSpot, Pipedrive, Salesforce (n8n template included).

Input

{
  "cnpj": "33000167000101",
  "sources": ["cadastral", "vagas"],
  "includeAiReport": true,
  "openaiApiKey": "sk-...",
  "maxProcurementDays": 180
}

Field	Type	Required	Default	Description
cnpj	string	✅	—	14 digits (formatted OK: 33.000.167/0001-01)
sources	array	—	["cadastral","vagas"]	Which sources to query. Options: cadastral, vagas, licitacoes
includeAiReport	boolean	—	true	Generate the AI commercial report (requires openaiApiKey)
openaiApiKey	string (secret)	—	—	Your OpenAI API key. Never stored or logged.
maxProcurementDays	int	—	180	How far back to search procurement (30-730)

Output (dataset item)

{
  "schemaVersion": "0.4",
  "cnpj": "33000167000101",
  "enrichedAt": "2026-04-17T...",
  "sources": {
    "cadastral": {
      "razaoSocial": "...",
      "situacaoCadastral": { "status": "Ativa", "motivo": null },
      "capitalSocial": 5000000,
      "cnaePrincipal": { "codigo": "...", "descricao": "..." },
      "socios": [{ "nome": "...", "faixaEtaria": "...", "cpfCnpjMascarado": "***912137**" }],
      "regimeTributarioHistorico": [{ "ano": 2024, "forma": "..." }]
    },
    "vagas": { "count": 12, "items": [...] },
    "licitacoes": { "count": 3, "totalValue": 4500000, "items": [...] }
  },
  "intelligence": {
    "commercialTier": { "tier": "HIGH", "reasons": [...] },
    "ageYears": 35,
    "ageCategory": "established",
    "flags": [...]
  },
  "indicators": {
    "isActive": true,
    "isHiring": true,
    "openingsCount": 12,
    "hasRecentProcurement": true,
    "commercialTier": "HIGH",
    "flagsCount": 0
  },
  "aiReport": {
    "available": true,
    "text": "...",
    "generatedInMs": 4200
  },
  "prospectaaiLink": "https://prospectaai.com.br/dossie/33000167000101",
  "meta": { "durationMs": 6800, "errors": [], ... }
}

Data sources

Source	API	Rate limit	License
minhareceita.org	https://minhareceita.org	generous	Public
publica.cnpj.ws (fallback)	https://publica.cnpj.ws	~3 req/min per IP	Public
Gupy	https://portal.api.gupy.io	—	Public job feed
PNCP	https://pncp.gov.br/api/consulta	—	Public gov
OpenAI (AI report, optional)	https://api.openai.com	your quota	Your own key

Pricing

Pay per event:

• Actor start: $0.06 per run
• Result (dataset item): $0.08 per enriched CNPJ
• AI commercial report: $0.12 per run (only charged when the report is actually generated and openaiApiKey is provided — your OpenAI usage is billed separately by OpenAI)

Typical run with all sources + AI report: $0.26 plus your OpenAI cost ($0.002-0.005 with gpt-4o-mini).

Need more signals? Try ProspectaAI

This actor returns structured data from 3 public sources. The full Signal-to-Action Sales OS is at prospectaai.com.br — it's what we built this actor from.

What you get on top of this actor:

• Signal scoring across 8+ sources — hiring + Meta Ads + Google News + new domains + BNDES financing + procurement + website changes + LinkedIn decision-makers
• WhatsApp message generator — auto-drafts the opener based on the specific signal detected ("saw you just posted 5 openings for SDRs...")
• Automated outreach cadence with tracking pixel and reply detection
• LinkedIn + phone waterfall — decision-maker enrichment with 8-pattern email verification
• CRM sync to HubSpot, Pipedrive, Salesforce, RD Station (OAuth-ready)

→ Free trial: 10 qualified leads/day, no credit card — or DM the founder (Antonio Rincon, linkedin.com/in/antoniohertzog) with your use case and get a 7-day expanded trial (50 leads with signals).

This actor handles raw data. ProspectaAI handles the "which lead do I call right now and what do I say?" layer.

Integration templates

Ready-to-use in ./templates/:

• n8n: n8n-cnpj-enrichment.json — CNPJ → enrich → HubSpot upsert (swap last node for any CRM)
• Zapier: coming soon
• Make.com: coming soon

Local development

npm install
node src/test-local.js   # smoke test against 3 real CNPJs

Deployment

apify login
apify push

Changelog

• 0.5 (Apr 2026): hotfix for Gupy API breaking change — name parameter replaced by jobName. Vagas source now uses waterfall search (5 common role terms) + local filter by careerPageName/jobUrl match. Coverage limited to companies using Gupy as ATS (~40% of BR market).
• 0.4 (Apr 2026): replaced PNCP default with Gupy (job postings); score replaced by qualitative tier; AI report now inferential with variable tone; schemaVersion field added
• 0.3 (Apr 2026): added AI commercial report (optional, pay-per-event); switched primary cadastral source to minhareceita.org for richer data (tax regime history, partner age range)
• 0.2 (Apr 2026): added aggregated intelligence layer (tier, flags, age category)
• 0.1 (Apr 2026): initial release with cadastral + licitacoes sources