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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Madkudu

MadKudu API (MadAPI)

The current MadKudu API (MadAPI) exposes account and person lookup, full account/person details and activities, company hiring/job-posting enrichment, advanced account and person search, prospect discovery and contact enrichment through connected sourcing providers (Apollo, Cognism, ZoomInfo), Tavily-backed AI web search, tenant organisation/value-prop endpoints, and a custom ingestion API documented as "Coming Soon" — 19 operations in all. Authentication is a raw API key in the x-api-key header; billing is credit-metered per call (HTTP 429 on exhaustion) with no rate-limit response headers.

Documentation Provider Profile APIs.io OpenAPI GitHub

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

Requests are made against 2 base URLs: https://madapi.madkudu.com, https://madapi.wisekudu.com.

19 operations 19 paths 93 schemas 8 GET11 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://madapi.madkudu.com
Authentication
API Key
Resource Areas
9

Authentication & Security 1

MadKudu API (MadAPI) declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 19

Across 19 paths, the API surfaces 19 operations — 8 GET, 11 POST. They span 9 resource areas: Lookup, Accounts, Persons, Enrichment, Search, Sourcing, AI, Organisation, Ingestion. Each is listed below with its method, path, parameters, and response codes.

Lookup 2
GET
/lookup/accounts
Lookup account by identifiers
Lookup_lookupAccounts 5 params → 200422
GET
/lookup/persons
Lookup person by identifiers
Lookup_lookupPersons 4 params → 200422
Accounts 3
GET
/accounts/{mk_id}
Get Account By Id
Accounts_getAccount 1 param → 200
POST
/accounts/{mk_id}/activities
Get Account Activities
Accounts_getAccountActivities 1 param body → 200
GET
/accounts/{mk_id}/top-persons
Get Account Top Persons
Accounts_getAccountTopPersons 2 params → 200
Persons 2
GET
/persons/{mk_id}
Get Person By Id
Persons_getPerson 1 param → 200
POST
/persons/{mk_id}/activities
Get Person Activities
Persons_getPersonActivities 1 param body → 200
Enrichment 1
POST
/enrichment/job-postings
Search job postings from a company
Enrichment_searchJobPostings body → 200422
Search 2
POST
/search/accounts
Search accounts
Search_searchAccounts body → 200422
POST
/search/persons
Search persons
Search_searchPersons body → 200422
Sourcing 3
GET
/sourcing/providers
Get available sourcing providers
Sourcing_getProviders → 200
POST
/sourcing/persons/discover
Discover persons using data providers
Sourcing_discoverPersons body → 200
POST
/sourcing/persons/enrich
Enrich person with contact information
Sourcing_enrichPerson body → 200
AI 1
POST
/ai/web-search
AI Web Search
AI_webSearch body → 200
Organisation 2
GET
/organisation
Get your Organisation information
Organisation_getOrganisation → 200
GET
/organisation/value-prop
Get Organisation Value Proposition
Organisation_getValueProposition → 200
Ingestion 3
POST
/ingestion/upload-json
Import data via API
Ingestion_uploadJson body → 200
POST
/ingestion/generate-upload-url
Generate Upload Url
Ingestion_generateUploadUrl body → 200
POST
/ingestion/confirm-upload
Confirm Upload
Ingestion_confirmUpload body → 200

Schemas 93

The contract defines 93 schemas that model the data the API accepts and returns. The most detailed are ZoomInfoFilters (78 properties), CognismAccountFilters (30 properties), CognismFilters (28 properties), ApolloFilters (21 properties). Each schema is shown below with its type and property counts.

AccountDetailsMini
object
14 properties 6 required
Common.Models.SourceSystem
object
3 properties 3 required
Common.Models.AccountSocials
object
4 properties
Common.Models.Location
object
3 properties
Common.Errors.ValidationError
object
Error return when body sent is invalid
1 property 1 required
PersonDetailsMini
object
14 properties 7 required
Common.Models.CompanyReference
object
2 properties 2 required
Common.Models.PersonSocials
object
4 properties
Common.Models.AccountDetail
object
16 properties 8 required
Common.Models.Scores
object
2 properties 2 required
Common.Models.CustomerFit
object
3 properties 2 required
Common.Models.LikelihoodToBuy
object
2 properties 2 required
Common.Models.AggregationValue
object
2 properties 2 required
Common.Models.AccountActivityResponse
object
2 properties 2 required
Common.Models.AccountActivity
object
1 property 1 required
Common.Models.PersonDetail
object
16 properties 9 required
Common.Models.ActivityBase
object
6 properties 6 required
Common.Models.Meta
object
4 properties
Common.Models.AccountActivitySearchRequest
object
6 properties
Common.Models.AccountActivityFilter
object
3 properties 3 required
Common.Models.AccountActivityFilterProperty
string
Common.Models.FilterOperator
string
Common.Models.SortingParam
object
2 properties 2 required
Common.Models.PersonActivityResponse
object
2 properties 2 required
Common.Models.PersonActivity
object
Common.Models.PersonActivitySearchRequest
object
6 properties
Common.Models.PersonActivityFilter
object
3 properties 3 required
Common.Models.PersonActivityFilterProperty
string
JobPostingSearchResponse
object
2 properties 2 required
JobPosting
object
9 properties 6 required
SearchMeta
object
4 properties
JobPostingSearchRequestBody
object
7 properties 1 required
JobPostingFilter
object
3 properties 3 required
JobPostingFilterField
string
FilterOperator
string
FilterLogic
string
SortingParam
object
2 properties 2 required
SortOrder
string
AccountSearchResponse
object
2 properties 2 required
AccountDetailSearch
object
15 properties 7 required
AccountSearchRequest
object
6 properties
AccountSearchFilter
object
3 properties 3 required
PersonSearchResponse
object
2 properties 2 required
PersonDetailSearch
object
15 properties 8 required
PersonSearchRequest
object
6 properties
PersonSearchFilter
object
3 properties 3 required
SourcingProvider
object
2 properties 2 required
PersonDiscoverResponse
object
2 properties 2 required
SourcingPersonResult
object
12 properties 4 required
PersonDiscoverResponsePagination
object
5 properties 2 required
PersonDiscoverRequest
ApolloDiscoverRequest
object
3 properties 1 required
ApolloFilters
object
21 properties
PersonDiscoverPagination
object
3 properties
ZoomInfoDiscoverRequest
object
3 properties 1 required
ZoomInfoFilters
object
78 properties
ZoomInfoAccuracyScoreRange
object
2 properties
ZoomInfoRevenueRange
object
2 properties
ZoomInfoEmployeeRange
object
2 properties
ZoomInfoContactRange
object
2 properties
ZoomInfoGrowthRateRange
object
2 properties
ZoomInfoFundingRange
object
2 properties
CognismDiscoverRequest
object
3 properties 1 required
CognismFilters
object
28 properties
CognismEducation
object
2 properties
CognismPhoneQuality
object
3 properties
CognismEmailQuality
object
3 properties
CognismDateRange
object
2 properties
CognismAccountFilters
object
30 properties
CognismRevenueRange
object
2 properties
CognismFoundedRange
object
2 properties
CognismHeadcountRange
object
2 properties
CognismSearchOptions
object
3 properties
PersonEnrichRequest
object
2 properties 2 required
WebSearchResponse
object
6 properties 4 required
WebSearchImageResult
object
2 properties 1 required
WebSearchResult
object
6 properties 4 required
WebSearchRequest
object
15 properties 1 required
OrganisationResponse
object
5 properties 5 required
ValueProposition
object
2 properties 2 required
JsonUploadResponse
object
Response model for JSON upload
3 properties 3 required
JsonUploadRequest
object
Request model for direct JSON upload
2 properties 2 required
AcceptedStream
string
Accepted streams for customer data
Contact
object
Contact model for ingestion
4 properties 3 required
Account
object
Account model for ingestion
4 properties 3 required
ContactEvent
object
Contact event model for ingestion
6 properties 5 required
AccountEvent
object
Account event model for ingestion
6 properties 5 required
UploadResponse
object
2 properties 2 required
UploadRequest
object
3 properties 3 required
ContentType
string
Content types for customer data
ContentEncoding
string
Content encodings for customer data
ConfirmUploadResponse
object
2 properties 2 required
ConfirmUploadRequest
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

madkudu-madapi-openapi.yml Raw ↑
#Sales Intelligence#Enrichment#Search#Sourcing
← Back to M APIs
API Details
ID
madkudu:madkudu-api-madapi
Base URL
https://madapi.madkudu.com
Docs
https://developers.madkudu.com/api
Provider
Madkudu
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=madkudu-madkudu-api-madapi&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/madkudu-madkudu-api-madapi"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of MadKudu API (MadAPI), 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.