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
This operation allows you to look up an account by various identifiers such as domain, mk_id, or LinkedIn handle. It returns detailed information about the account if found.
Domain of the account to look up
LinkedIn company handle with prefix (e.g., 'company/madkudu')
Twitter handle
Crunchbase organization handle with prefix (e.g., 'organization/madkudu')
External CRM ID (e.g., Salesforce Account ID, HubSpot Account ID)
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"
}
}
]This operation allows you to look up a person by various identifiers such as email, mk_id, or linkedIn handle. It returns detailed information about the person if found.
Email address of the person
LinkedIn profile handle with prefix (e.g., 'in/francisbrero')
Twitter handle
External CRM ID (e.g., Salesforce Lead/Contact ID, HubSpot Contact ID)
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?