Skip to content

Score API [Starter]

Returns a composite score (0–800, higher is better) for any domain, reflecting company size, time in business, and technology adoption. Based on ten years of SSL certificate history. Subdomains are automatically normalized.

Use alongside BizData for full firmographic profiles and Growth for quarter-over-quarter changes.

The score combines four components: a base score from historical certificate activity, a recency multiplier that rewards sustained activity, a growth boost comparing recent vs older activity, and an expiration penalty for certificates nearing expiration.

ComponentDescription
Base Score (β)Accumulated points from 10 years of certificate history, weighted by market and time
Recency Multiplier (ε)Ranges 0-1; penalizes domains where all certificates are very recent
Growth Boost (φ)Positive if certificate activity increased year-over-year, negative if declined
Expiration Penalty (λ)Reduces score when certificates are within 14 days of expiring

1. Base Score — For each of the past 10 years, we calculate how many certificates were issued compared to the expected baseline for the market. More certificates = more points, with a cap at 100% of baseline.

2. Recency Check — If all certificates were issued within the current year, the score is reduced proportionally. A domain with 3+ years of history gets the full score.

3. Growth Adjustment — We compare certificate activity from the past 360 days against the prior 360 days (720-360 days ago). Growing companies get a boost; declining activity results in a penalty.

4. Expiration Penalty — If certificates are about to expire (within 14 days), the final score is reduced to reflect potential domain inactivity.

SymbolNameNotes
ΔTDays since the first certificate was issued in the last 3 yearsCertificates with a validity period over three years are ignored
εRecency Penalty multiplierDecreases score in case all company certificates were created in the current year
|Cy|Certificates per yearNumber of certificates generated in a year
βcertsBaseline Certificate NumberCalculated number of certificates expected for a business
βptBaseline pointsThe number of points to be awarded for a year (distribution of points between years is not uniform)
τMarket CoefficientEstablishes a more accurate baseline for each specific market
Ω360Lookback 360Number of certificates generated in the past 360 days
Ω720Lookback 720Number of certificates generated between 720 and 360 days
βBase scoreThe baseline score for the domain provided over ten years
θGrowth pointsPoints awarded for growth, currently static at 50
φGrowth boostYear-over-year growth metric
ΔτDays until the expiration of certificate
λdExpiration penalty rangeRange is in days (currently static at 14 days)
λExpiration penaltyDecreases score in case the average expiration period of currently valid certificates has passed by more than λd
ε=min(ΔT365,1)\varepsilon = \min\left(\frac{\Delta T}{365},\, 1\right) β=y=110(min(Cyβcerts,1)βptτ(0.4+0.5exp((x6)28)+0.05(x1)))\beta = \sum_{y=1}^{10}\left(\min\left(\frac{\lvert C_y \rvert}{\beta_{\text{certs}}},\, 1\right)\cdot \beta_{\text{pt}}\cdot \tau \cdot \left(0.4 + 0.5 \cdot \exp\left(\frac{(x - 6)^2}{8}\right) + 0.05 \cdot (x - 1)\right)\right) (Ω360Ω720θsign=1)(Ω360<Ω720θsign=1)(\Omega_{360} \geq \Omega_{720} \rightarrow \theta_{\text{sign}} = 1) \wedge (\Omega_{360} < \Omega_{720} \rightarrow \theta_{\text{sign}} = -1) φ=Ω360Ω720Ω360+Ω720θ\varphi = \frac{\Omega_{360} - \Omega_{720}}{\Omega_{360} + \Omega_{720}} \cdot \theta λ=μ(min(Δτ+λdλd,1))\lambda = \mu\left(\min\left(\frac{\Delta\tau + \lambda_d}{\lambda_d},\, 1\right)\right) Score=(βε+φ)λ\text{Score} = (\beta \cdot \varepsilon + \varphi) \cdot \lambda
GET https://api.discolike.com/v1/score
ParameterDescription
domainDomain to investigate.
FieldFormatDescription
domainStringNormalized domain name (excluding any subdomain).
scoreUnsigned Int32Final calculated score.
first_eventDate (YYYY-MM-DD)Date of first registration event.
confidenceDecimal (1,2)Confidence score for classification label.
parametersArray[ParameterObjects]Set of calculation parameters as described in the parameters section.
base_scoreDecimal (3,2)The baseline score for the domain provided over 10 years (β).
recency_multiplierDecimal(1,2)Decreases score in case of all company certificates were created in the current year (ε).
growth_boostDecimal(3,2)Increases score if the number of certificates opened in the last 360 days is greater than those opened 2 years before or decreases one if vice versa (φ).
expiration_penaltyDecimal(1,2)Decreases score in case of the average expiration period of currently active certificates is less than λd (λ).
lookback_360Unsigned Int32Number of certificates generated in the past 360 days (Ω360).
lookback_720Unsigned Int32Number of certificates generated between 720 and 360 days (Ω720).
Terminal window
curl "https://api.discolike.com/v1/score?domain=acmecorp.com" \
-H "x-discolike-key: API_KEY"
{
"domain": "acmecorp.com",
"score": 657,
"parameters": {
"base_score": 700,
"recency_multiplier": 1,
"growth_boost": -42.78,
"lookback_360": 14796,
"lookback_720": 190199,
"expiration_penalty": 1
},
"first_event": "2010-03-01"
}