scala-score

June 6, 2026 · View on GitHub

Python SDK for S.C.A.L.A. Score API — search 244M+ companies across 40+ countries.

Install

pip install scala-score

Quick Start

from scala_score import ScalaScore

score = ScalaScore("your-api-key")

# Search companies
results = score.search("Ferrero", country="IT")
for company in results.companies:
    print(f"{company.name} — {company.city} — Revenue: €{company.revenue:,.0f}")

# Lookup by VAT number
company = score.lookup("IT02727330014")
print(f"{company.name}: health score {company.health_score}/100")

# Generate a report
report = score.report("IT02727330014", report_type="pro")
print(f"Report: {report.download_url}")

# Check credits
credits = score.credits()
print(f"Remaining: {credits['credits_remaining']} credits")

# Database stats
stats = score.stats()
print(f"Total companies: {stats['total_companies']:,}")

Search with Filters

# Find active restaurants in Milan
results = score.search(
    "ristorante",
    country="IT",
    nace="56.10",      # NACE code for restaurants
    status="active",
    limit=50
)

# Find construction companies in Germany
results = score.search("bau", country="DE", nace="41", limit=20)

# Find tech companies in Spain
results = score.search("tecnología", country="ES", nace="62.01")

Company Data Fields

Each company includes (when available):

Field	Description
`name`	Company legal name
`country`	ISO 2-letter code
`vat_number`	VAT / Tax ID
`address`, `city`, `postal_code`	Location
`nace_code`, `nace_description`	Industry classification
`legal_form`	SRL, GmbH, Ltd, SA, etc.
`status`	Active / Inactive / Dissolved
`revenue`	Estimated annual revenue (€)
`employees`	Employee count
`health_score`	Financial health (0-100)
`founded`	Incorporation date
`website`, `phone`, `email`	Contact info

Coverage

244M+ companies across 40+ countries including:

Country	Companies	Source
🇮🇹 Italy	6.2M	Camera di Commercio
🇩🇪 Germany	5.4M	Handelsregister
🇫🇷 France	29.5M	SIRENE/INSEE
🇬🇧 UK	5.8M	Companies House
🇪🇸 Spain	3.7M	BORME
🇺🇸 USA	35M+	SEC + State registries
🇳🇱 Netherlands	2.8M	KVK
+ 33 more countries	...	Government registries

Pricing

Plan	Price	Credits/mo	Per lookup
Starter	€19/mo	500	€0.038
Growth	€49/mo	5,000	€0.010
Enterprise	€149/mo	50,000	€0.003

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

Get API Key

Sign up at app.get-scala.com
Go to Score > API
Generate your key
pip install scala-score and start searching

License

MIT