Lead Scoring
Calculate quality scores and tier classifications for business leads. Configurable scoring rules and tier criteria. Returns transparent score breakdowns.
⚡ Built-in — No Setup Required
This integration is built into the WebsitePublisher platform. All endpoints are available immediately — no API key needed.
Endpoints (2)
POST
calculate
Calculate lead score and tier for a single company. Provide company data and optionally custom scoring rules and tier criteria. Returns score (-3 to +7 with defaults), tier (T1/T2/T3), and a transparent breakdown of every rule applied.
| Field | Type | Required | Description |
|---|---|---|---|
company |
array | ✓ Yes | Company data object. Expected fields: handelsnaam, telefoon, website, email, is_hoofdvestiging (bool), werkzame_personen (int|null), sbi_codes (array), google_rating (float|null), google_reviews_count (int|null). Missing fields are treated as absent. |
rules |
array | No | Custom scoring rules. If omitted, defaults are used. Keys: telefoon_present (+1), website_present (+1), email_present (+1), hoofdvestiging_bonus (+2), holding_penalty (-2), missing_field_penalty (-1), google_rating_threshold (3.5), google_rating_max_bonus (+2). Values are the points awarded/deducted. |
tier_criteria |
array | No | Tier classification criteria. Object with t1, t2 keys, each containing: wp_min, wp_max (employee range), require_hoofdvestiging (bool), exclude_name_patterns (array of strings). Companies not matching T1 or T2 are classified as T3. |
holding_sbi_codes |
array | No | SBI codes that indicate a holding company. Default: ["64200","64201","64202","70100","70101","70102","68201"]. |
holding_name_patterns |
array | No | Name patterns (case-insensitive) that indicate a holding. Default: ["holding","beheer","investments","beleggingen","participaties"]. |
POST
batch-calculate
Calculate lead scores and tiers for multiple companies in one call. Same rules and criteria applied to all. Returns array of scored companies sorted by score (highest first). Max 500 companies per call.
| Field | Type | Required | Description |
|---|---|---|---|
companies |
array | ✓ Yes | Array of company data objects. Same format as single calculate. Max 500 items. |
rules |
array | No | Custom scoring rules (same as calculate endpoint). Applied to all companies. |
tier_criteria |
array | No | Tier criteria (same as calculate endpoint). Applied to all companies. |
holding_sbi_codes |
array | No | |
holding_name_patterns |
array | No | |
sort_by |
string | No | Sort results by: "score" (default, highest first), "tier" (T1 first), or "name" (alphabetical). |
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| calculate | lead-scoring_calculate |
| batch-calculate | lead-scoring_batch_calculate |