Detailed Information
Get the full picture on any person or account using the MadKudu ID
Use these endpoints to fetch rich context about a person or account using the MadKudu ID. Perfect for surfacing firmographics, demographics, engagement metrics, and scores in your tools or workflows
Retrieve comprehensive account information including firmographics, customer fit scoring, activity metrics, and contact details.
The request has succeeded.
Unique identifier for the account in MadKudu
Account name
Account domain
Logo URL
Account description
Industry
Founded year
Raised amount
Number of employees
Number of active users
Total activities count
Aggregations data
GET /accounts/{mk_id} HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*
The request has succeeded.
{
"mk_id": "salesforce_Account_Id_0011K000027UadJQAS",
"source_system": {
"id": "0011K000027UadJQAS",
"system": "salesforce",
"object": "Account"
},
"name": "MadKudu",
"domain": "madkudu.com",
"logo": "https://logo.clearbit.com/madkudu.com",
"description": "MadKudu provides a customer data platform that enables sales and customer success teams to identify and act on buying signals quickly enhancing their ability to engage with customers and reduce churn through automated insights and actions",
"industry": "Internet Software & Services",
"founded_year": 2014,
"raised_amount": 27100000,
"employees_count": 52,
"active_users": 48,
"activities_count": 434415,
"socials": {
"linkedin_handle": "company/madkudu",
"twitter_handle": "madkudu",
"crunchbase_handle": "organization/madkudu",
"website": "https://madkudu.com"
},
"location": {
"country": "United States",
"state": "",
"city": "Mountain View"
},
"scores": {
"customer_fit": {
"score": 49,
"segment": "low",
"signals": "✅ Company likely using Salesforce \n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52\n✅ Company industry is Software \n❌ Website traffic is medium large (10k-100k visitors/month) "
},
"likelihood_to_buy": {
"score": 100,
"segment": "very high"
}
},
"aggregations": {}
}Get activities associated with an account including website visits, email engagement, product usage, and sales touchpoints. Filter by activity type, date range, or specific team members.
Number of results to return
Cursor for pagination
Search query
Filter logic
The request has succeeded.
POST /accounts/{mk_id}/activities HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 192
{
"limit": 10,
"cursor": 20,
"search": "MSI",
"filters": [
{
"property": "activity_type",
"operator": "NOT_IN",
"value": [
"Job Activity"
]
}
],
"filterLogic": "AND",
"sort": [
{
"sort_by": "name",
"sort_order": "asc"
}
]
}The request has succeeded.
{
"data": [
{
"event_id": "624a8797f10aeb9acc239104c3a521fe",
"event": "Opened MSI Email Digest",
"event_display": "Opened Copilot Email Digest",
"event_timestamp": "2025-03-05T18:48:13",
"activity_type": "App Usage",
"account_id": "salesforce_Account_Id_0011K000027UadJQAS",
"person": {
"mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
"source_system": {
"id": "00Q1K000011Oac0UAC",
"system": "salesforce",
"object": "Lead"
},
"email": "francis@madkudu.com",
"name": "Francis Brero",
"first_name": "Francis",
"last_name": "Brero",
"title": "Co-founder",
"persona": "",
"avatar": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/50eb56e0-cc77-4468-a133-a685c8ed5715",
"company": {
"domain": "madkudu.com",
"mk_id": "salesforce_Account_Id_0011K000027UadJQAS"
},
"socials": {
"linkedin_handle": "in/francisbrero",
"twitter_handle": "",
"crunchbase_handle": "",
"website": ""
},
"location": {
"country": "United States",
"state": "",
"city": "Mountain View"
},
"has_left_company": false,
"scores": {
"customer_fit": {
"score": 49,
"segment": "low",
"signals": "✅ Company likely using Salesforce \n✅ Title is Co-founder\n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52\n❌ Website traffic is medium large (10k-100k visitors/month) "
},
"likelihood_to_buy": {
"score": 96,
"segment": "very high"
}
},
"activities": 11974,
"aggregations": {}
}
}
],
"meta": {
"limit": 10,
"has_next_page": true,
"next_cursor": 30
}
}Fetch the most engaged contacts at a company, ranked by activity level and seniority. Helps identify champions, decision makers, and active stakeholders for targeted outreach and relationship building.
The request has succeeded.
Unique identifier for the person in MadKudu
Email address
Full name
First name
Last name
Job title
Persona
Avatar URL
Has left company
Activities information
Aggregations data
GET /accounts/{mk_id}/top-persons HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*
The request has succeeded.
[
{
"mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
"source_system": {
"id": "00Q1K000011Oac0UAC",
"system": "salesforce",
"object": "Lead"
},
"email": "francis@madkudu.com",
"name": "Francis Brero",
"first_name": "Francis",
"last_name": "Brero",
"title": "Co-founder",
"persona": "",
"avatar": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/50eb56e0-cc77-4468-a133-a685c8ed5715",
"company": {
"domain": "madkudu.com",
"mk_id": "salesforce_Account_Id_0011K000027UadJQAS"
},
"socials": {
"linkedin_handle": "in/francisbrero",
"twitter_handle": "",
"crunchbase_handle": "",
"website": ""
},
"location": {
"country": "United States",
"state": "",
"city": "Mountain View"
},
"has_left_company": false,
"scores": {
"customer_fit": {
"score": 49,
"segment": "low",
"signals": "✅ Company likely using Salesforce \n✅ Title is Co-founder\n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52\n❌ Website traffic is medium large (10k-100k visitors/month) "
},
"likelihood_to_buy": {
"score": 96,
"segment": "very high"
}
},
"activities": 11974,
"aggregations": {}
}
]Retrieve comprehensive person information including job details, company background, engagement scoring, and activity metrics.
The request has succeeded.
Unique identifier for the person in MadKudu
Email address
Full name
First name
Last name
Job title
Persona
Avatar URL
Has left company
Activities information
Aggregations data
GET /persons/{mk_id} HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*
The request has succeeded.
{
"mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
"source_system": {
"id": "00Q1K000011Oac0UAC",
"system": "salesforce",
"object": "Lead"
},
"email": "francis@madkudu.com",
"name": "Francis Brero",
"first_name": "Francis",
"last_name": "Brero",
"title": "Co-founder",
"persona": "",
"avatar": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/50eb56e0-cc77-4468-a133-a685c8ed5715",
"company": {
"domain": "madkudu.com",
"mk_id": "salesforce_Account_Id_0011K000027UadJQAS"
},
"socials": {
"linkedin_handle": "in/francisbrero",
"twitter_handle": "",
"crunchbase_handle": "",
"website": ""
},
"location": {
"country": "United States",
"state": "",
"city": "Mountain View"
},
"has_left_company": false,
"scores": {
"customer_fit": {
"score": 49,
"segment": "low",
"signals": "✅ Company likely using Salesforce \n✅ Title is Co-founder\n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52\n❌ Website traffic is medium large (10k-100k visitors/month) "
},
"likelihood_to_buy": {
"score": 96,
"segment": "very high"
}
},
"activities": 11974,
"aggregations": {}
}Get activities associated with a person including email opens, website visits, content downloads, and meeting attendance. Filter by activity type or date range to understand engagement patterns and optimize outreach timing.
Number of results to return
Cursor for pagination
Search query
Filter logic
The request has succeeded.
POST /persons/{mk_id}/activities HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 192
{
"limit": 10,
"cursor": 20,
"search": "MSI",
"filters": [
{
"property": "activity_type",
"operator": "NOT_IN",
"value": [
"Job Activity"
]
}
],
"filterLogic": "AND",
"sort": [
{
"sort_by": "name",
"sort_order": "asc"
}
]
}The request has succeeded.
{
"data": [
{
"event_id": "624a8797f10aeb9acc239104c3a521fe",
"event": "Opened MSI Email Digest",
"event_display": "Opened Copilot Email Digest",
"event_timestamp": "2025-03-05T18:48:13",
"activity_type": "App Usage",
"account_id": "salesforce_Account_Id_0011K000027UadJQAS"
}
],
"meta": {
"limit": 10,
"has_next_page": true,
"next_cursor": 30
}
}Last updated
Was this helpful?