S.C.A.L.A. Score — JavaScript/TypeScript SDK

Search 244M+ companies across 40+ countries from government registries. Zero scraping, just official public data normalized into a single API.

Install

npm install scala-score

Quick Start

import ScalaScore from "scala-score";

const score = new ScalaScore("your-api-key");

// Search companies
const results = await score.search("restaurant", { country: "DE", nace: "56.10", limit: 20 });
console.log(`Found ${results.total} companies`);

// Lookup by ID or VAT
const company = await score.lookup("IT02727330014");
console.log(company.name, company.health_score);

// Generate report
const report = await score.report("IT02727330014", "basic");

// Check credits
const credits = await score.credits();
console.log(`${credits.credits_remaining} credits left`);

API Methods

| Method | Description | Credits | |--------|-------------|---------| | search(query, options?) | Search by name/VAT/keyword with country, NACE, status filters | 1 | | lookup(companyId) | Full company profile by ID or VAT | 1 | | report(companyId, type?) | Generate health report (basic/pro/enterprise) | 5/10/20 | | credits() | Check remaining API credits | 0 | | stats() | Database statistics (total companies, countries) | 0 | | countries() | List countries with company counts | 0 |

Search Options

const results = await score.search("ferrero", {
  country: "IT",       // ISO 2-letter country code
  nace: "10.82",       // NACE industry code
  status: "active",    // "active" | "inactive"
  limit: 25,           // max results (default: 10)
});

Company Fields

Each company includes (when available): name, country, vat_number, address, city, postal_code, nace_code, nace_description, legal_form, status, revenue, employees, health_score, founded, website, phone, email.

Get API Key

1. Sign up at app.get-scala.com
2. Go to Score > API
3. Generate your key

Pricing

| Plan | Price | Lookups/mo | |------|-------|-----------| | Starter | €19/mo | 500 | | Growth | €49/mo | 5,000 | | Enterprise | €149/mo | 50,000 |

Compare: Dun & Bradstreet charges €2-5 per lookup. ZoomInfo starts at $15K/year.

Links

• Python SDK
• MCP Server — AI agents search companies
• n8n node — Workflow automation
• S.C.A.L.A. AI OS — Full platform

License

MIT