How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

MadKudu Legacy Scoring API

The legacy MadKudu Scoring API returns customer-fit (demographics), likelihood-to-buy and lead-grade scores for companies by domain and persons by email, plus a job-changes watch list and a ping utility — 6 operations. Authentication is HTTP Basic (API key as username, empty password) with a different key from MadAPI; rate limited to 600 requests per endpoint per minute (HTTP 429 when exceeded). MadKudu labels this surface "Legacy" and steers new integrations to MadAPI, but publishes no dated deprecation or sunset policy.

This API exposes 6 operations across 4 paths, organized into 4 resource areas, and defines 34 schemas. It is described by OpenAPI 3.1.0, at version 0.0.0.

Requests are made against a single base URL, https://api.madkudu.com.

6 operations 4 paths 34 schemas 3 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.0.0
Base URL
https://api.madkudu.com
Authentication
HTTP Basic
Resource Areas
4

Authentication & Security 1

MadKudu Legacy Scoring API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (BasicAuth). By default, every request must be authenticated.

Paths & Operations 6

Across 4 paths, the API surfaces 6 operations — 3 GET, 3 POST. They span 4 resource areas: Utilities, Companies, Persons, Job Changes. Each is listed below with its method, path, parameters, and response codes.

Utilities 1
GET
/v1/ping
Ping API endpoint
Utilities_ping → 200401429500
Companies 2
GET
/v1/companies
Lookup company by domain
Companies_lookupCompany 1 param → 200400401404429500
POST
/v1/companies
Lookup company with enriched payload
Companies_lookupCompanyWithPayload body → 200400401422429500
Persons 2
GET
/v1/persons
Lookup person by email
Persons_lookupPerson 1 param → 200400401404429500
POST
/v1/persons
Lookup person with enriched payload
Persons_lookupPersonWithPayload body → 200400401422429500
Job Changes 1
POST
/v1/integrations/job_changes/watch-list/csv
Set job changes watch list
JobChanges_setWatchList body → 200400401422429500

Schemas 34

The contract defines 34 schemas that model the data the API accepts and returns. The most detailed are Common.Models.ClearbitCompany (28 properties), Common.Models.ClearbitPerson (22 properties), Common.Models.SocialProfile (13 properties), Common.Models.GeoLocation (11 properties). Each schema is shown below with its type and property counts.

Services.Utilities.PingResponse
object
Ping response
1 property 1 required
Common.Errors.AuthenticationError
object
Authentication error
1 property 1 required
Common.Errors.RateLimitError
object
Rate limit exceeded error
2 properties 1 required
Common.Errors.InternalServerError
object
Internal server error
1 property 1 required
Services.Companies.CompanyLookupResponse
object
Company lookup response
3 properties 3 required
Common.Models.ObjectType
string
Object type identifier
Services.Companies.CompanyProperties
object
Company properties containing all company information
7 properties
Common.Models.Location
object
Geographic location information
5 properties
Common.Models.CustomerFit
object
Customer fit analysis with score and signals
4 properties 4 required
Common.Models.CustomerFitSegment
string
Customer fit segment values
Common.Models.Signal
object
Individual signal contributing to customer fit score
3 properties 3 required
Common.Models.SignalType
string
Signal type indicating positive or negative impact
Common.Errors.ValidationError
object
Validation error for request parameters
2 properties 1 required
Common.Errors.NotFoundError
object
Resource not found error
1 property 1 required
Services.Companies.CompanyLookupWithPayloadRequest
object
Company lookup with payload request
2 properties 2 required
Common.Models.ClearbitCompany
object
Complete Clearbit company payload
28 properties
Common.Models.CompanySite
object
Company site information
2 properties
Common.Models.CompanyCategory
object
Company category classification
6 properties
Common.Models.GeoLocation
object
Detailed geographic coordinates
11 properties
Common.Models.SocialProfile
object
Social media profile
13 properties
Common.Models.CompanyIdentifiers
object
Company identifiers
1 property
Common.Models.CompanyMetrics
object
Company metrics
9 properties
Common.Models.CompanyParent
object
Company parent information
1 property
Services.Persons.PersonLookupResponse
object
Person lookup response
4 properties 3 required
Services.Persons.PersonProperties
object
Person properties containing all person information
8 properties
Services.Persons.CompanyInfo
object
Company information associated with person
1 property 1 required
Services.Persons.CompanyInfoProperties
object
Company properties within person response
6 properties
Services.Persons.PersonLookupWithPayloadRequest
object
Person lookup with payload request
3 properties 3 required
Common.Models.ClearbitPerson
object
Complete Clearbit person payload
22 properties
Common.Models.ClearbitPersonName
object
Clearbit person name structure
3 properties
Common.Models.Employment
object
Employment information
5 properties
Common.Models.GravatarProfile
object
Gravatar profile
4 properties
Common.Models.GravatarAvatar
object
Gravatar avatar information
2 properties
Services.JobChanges.WatchListUploadResponse
object
Watch list upload response
3 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

madkudu-legacy-api-openapi.yml Raw ↑
Where this information came from

This is an independent, third-party profile of MadKudu Legacy Scoring API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.