Brazil Company Due Diligence — CNPJ Registry + Reclame Aqui Reputation

Vet any Brazilian company from a single input: its CNPJ (the 14-digit national company tax ID every registered business in Brazil carries). This Actor merges the official government registry (Receita Federal — Brazil's federal tax authority — via BrasilAPI) with the company's Reclame Aqui consumer reputation (Reclame Aqui is Brazil's dominant public complaints-and-reviews platform) — the two data points every due-diligence, KYB, onboarding or B2B-sales decision in Brazil actually needs — into one clean record per company.

Why this Actor

Registry data tells you a company is real and active. Reputation data tells you whether its customers are treated well. Alone, each is half the picture. The hard part is linking them: a company's consumer brand ("Nubank") is rarely its legal name ("NU PAGAMENTOS S.A."). Naive name matching attaches the wrong company's reputation — worse than no data at all.

This Actor solves that deterministically. Reclame Aqui stores each company's CNPJ in its own records, so the match is made by CNPJ, never by a fuzzy name guess:

• ✅ Never a wrong company. A reputation is attached only when the exact CNPJ (or its 8-digit corporate root) is found on the Reclame Aqui record.
• ✅ Honest abstain. If no Reclame Aqui page exists under that CNPJ, the Actor says so explicitly (reclame_aqui: null + a note) instead of guessing.
• ✅ Pay per result. Companies not found, invalid CNPJs and failed lookups are not returned and not charged.

Input

Field	Type	Description
cnpjs	array	One CNPJ per line. Formatted (47.960.950/0001-21) or digits-only both work.
maxItems	integer	Stop after N companies (cost control). Default 1000.
includeReputation	boolean	Look up Reclame Aqui reputation. Default true. Turn off for faster, registry-only runs.
includeRaw	boolean	Attach the full raw registry payload. Default false.

{
  "cnpjs": ["47960950000121", "18236120000158", "06164253000187"],
  "includeReputation": true
}

Output (one item per company)

{
  "tax_id": "47.960.950/0001-21",
  "registry": {
    "legal_name": "MAGAZINE LUIZA S/A",
    "trade_name": "MAGAZINE LUIZA",
    "status": "ATIVA",
    "founded": "1966-10-24",
    "age_years": 59.7,
    "main_activity": { "code": 4713004, "description": "Lojas de departamentos ou magazines" },
    "share_capital": 14202162000,
    "email": null,
    "phone": "1637112002",
    "address": { "city": "FRANCA", "state": "SP", "zip": "14400490" },
    "partners": [ { "name": "FREDERICO TRAJANO INACIO RODRIGUES", "role": "Presidente" } ]
  },
  "reclame_aqui": {
    "name": "Magazine Luiza - Loja Online",
    "reclame_aqui_url": "https://www.reclameaqui.com.br/empresa/magazine-luiza-loja-online/",
    "reputation_label": "RA1000",
    "reclame_aqui_score": "8.2",
    "total_complaints": 68288,
    "solved_percent": "91.6",
    "segment": "Varejo",
    "match_type": "exact_cnpj"
  },
  "reclame_aqui_note": null,
  "registry_risk": { "level": "low", "reasons": [] },
  "overall_risk": { "level": "low", "note": "active registry, acceptable reputation" }
}

When Reclame Aqui has no page for the CNPJ (e.g. a holding company whose reputation lives under an operating subsidiary):

{
  "tax_id": "06.164.253/0001-87",
  "registry": { "legal_name": "GOL LINHAS AEREAS INTELIGENTES S.A.", "status": "ATIVA" },
  "reclame_aqui": null,
  "reclame_aqui_note": "no Reclame Aqui page registered under this CNPJ (a parent/subsidiary CNPJ of the same group may have one)",
  "overall_risk": { "level": "low", "note": "active registry; no Reclame Aqui record found" }
}

Reputation fields

• reputation_label — Reclame Aqui's badge: RA1000 (best) · GREAT · GOOD · REGULAR · BAD · NOT_RECOMMENDED.
• reclame_aqui_score — the 0–10 reputation score, when published.
• total_complaints, solved_percent — complaint volume and resolution rate.
• match_type — exact_cnpj (full CNPJ match) or cnpj_root (same company, different establishment).
• other_brands_same_cnpj — other Reclame Aqui brands operating under the same CNPJ, if any.

Use cases

• KYB / due diligence — confirm a supplier, partner or acquisition target is active and well-regarded.
• B2B sales & lead qualification — enrich a list of CNPJs with contacts, activity and reputation before you call.
• Compliance & onboarding — screen new customers against official status and public reputation.
• Market & competitor research — pull registry + reputation across a whole segment.

Pricing

Pay per delivered company record (US$ 8.00 per 1,000 companies). Companies not found, invalid CNPJs and failed lookups are not returned and not charged.

FAQ

What is a CNPJ? The Cadastro Nacional da Pessoa Jurídica — the 14-digit federal ID every registered company in Brazil carries, the local equivalent of a company tax/registration number. Paste it formatted (47.960.950/0001-21) or as digits only; both work.

What are Receita Federal and BrasilAPI? Receita Federal is Brazil's federal tax authority; its public company registry is the source of the registry fields (legal name, status, owners, activity, capital, address). BrasilAPI is the open API this Actor reads that registry through.

What is Reclame Aqui? Brazil's most-used public complaints-and-reviews platform — the first place buyers check a company's reputation. It publishes a score, a reputation badge, complaint volume and the percentage of complaints the company has resolved.

What happens when a company has no Reclame Aqui page? The Actor abstains honestly: it returns the registry data with reclame_aqui: null and a reclame_aqui_note explaining why (often a holding company whose reputation lives under an operating subsidiary). It never invents or borrows another company's reputation.

Can it ever attach the wrong company's reputation? No. The match is made on the CNPJ stored inside Reclame Aqui's own records — never on a fuzzy name guess — so a reputation is attached only when the exact CNPJ (or its 8-digit corporate root) matches.

Do I pay for companies that aren't found? No. Not-found companies, invalid CNPJs and failed lookups are not returned and not charged. You pay only for delivered records.

Notes

• Registry source: Receita Federal via BrasilAPI. Reputation source: Reclame Aqui public data.
• Reputation lookups run through a real browser session, so they are slightly slower than registry-only runs; keep batches reasonable, or set includeReputation: false for registry-only speed.

Related Actors

• Brazil Company Data — Bulk CNPJ Lookup & Enrichment — registry data only, when you don't need reputation
• Brazil Protest / Default Check — credit-risk signal by CPF/CNPJ — checks protested debts by CPF/CNPJ in the official São Paulo protest registry (CENPROT): a direct default and credit-risk signal for KYB
• Google News Scraper — Real Article URLs — real publisher URLs for news monitoring and LLM pipelines

Changelog

• v1.0 — Initial release: deterministic CNPJ-matched registry + Reclame Aqui reputation in one record, honest abstain when no reputation page exists, pay-per-result billing.

Contact

Issues, feature requests or a data field you need added? Open an issue on the Actor's Issues tab and I'll take a look.