scala-score

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):

Coverage

244M+ companies across 40+ countries including:

Pricing

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

Get API Key

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

Links

• API Documentation
• S.C.A.L.A. AI OS — Full platform with CRM, WhatsApp AI, 15 industry verticals
• n8n Integration

License

MIT