Lookup
Find any account or person by the identifier you have (email, domain Linkedin handle, Twitter, salesforce ID, hubspot ID ...) and get their MadKudu ID.
Each endpoint accepts multiple types of identifiers as input, and returns MadKudu ID, social IDs, system IDs and enriched attributes, making it easy to build a robust identity graph across your systems.
These endpoints are ideal for:
Resolving identities across tools and platforms
Getting the person/account ID for the Detailed Information endpoints
Enriching your CRM or CDP with consistent person/account data
Lookup accounts in your database using domain names, social media handles, or CRM IDs. Returns company profile with contact details, firmographics, and customer fit scoring. Use it to get the MadKudu ID to fetch more information in the Detailed Information endpoints.
Company website domain (e.g., 'madkudu.com')
LinkedIn company page handle (e.g., 'company/madkudu')
Twitter company handle
Crunchbase company profile handle (e.g., 'organization/madkudu')
Your CRM account ID (Salesforce, HubSpot, etc.)
The request has succeeded.
Client error
GET /lookup/accounts HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*
[
{
"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": 51,
"activities_count": 430840,
"socials": {
"linkedin_handle": "company/madkudu",
"twitter_handle": "madkudu",
"crunchbase_handle": "organization/madkudu",
"website": "https://madkudu.com"
},
"location": {
"country": "United States",
"city": "Mountain View"
}
}
]Lookup people in your database using email addresses, social media profiles, or CRM IDs. Returns contact profile with job details, company information, and lead scoring. Use it to get the MadKudu ID to fetch more information in the Detailed Information endpoints.
Person's email address
LinkedIn profile handle (e.g., 'in/francisbrero')
Twitter profile handle
Your CRM contact ID (Salesforce Lead/Contact, HubSpot Contact, etc.)
The request has succeeded.
Client error
GET /lookup/persons HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*
[
{
"mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
"source_system": {
"id": "00Q1K000011Oac0UAC",
"system": "salesforce",
"object": "Lead"
},
"email": "[email protected]",
"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": ""
},
"location": {
"country": "United States",
"state": "California",
"city": "Mountain View"
},
"activities": null
},
{
"mk_id": "salesforce_Lead_Id_00Q1K000011Oac1UAC",
"source_system": {
"id": "00Q1K000011Oac1UAC",
"system": "salesforce",
"object": "Lead"
},
"email": "[email protected]",
"name": "Francis Brero",
"first_name": "Francis",
"last_name": "Brero",
"title": "Co-founder",
"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"
},
"location": {
"country": "United States",
"state": "California",
"city": "Mountain View"
},
"activities": null
}
]Last updated
Was this helpful?