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 account by identifiers

get

https://madapi.madkudu.comhttps://madapi.wisekudu.com

/lookup/accounts

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.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

domainstringOptional

Company website domain (e.g., 'madkudu.com')

linkedinstringOptional

LinkedIn company page handle (e.g., 'company/madkudu')

twitterstringOptional

Twitter company handle

crunchbasestringOptional

Crunchbase company profile handle (e.g., 'organization/madkudu')

external_idstringOptional

Your CRM account ID (Salesforce, HubSpot, etc.)

Responses

200

The request has succeeded.

application/json

mk_idstringRequired

Unique identifier for the account in MadKudu

namestringRequired

Name of the account

domainstringRequired

Domain of the account

logostringOptional

URL of the account's logo

descriptionstringOptional

Description of the account

industrystringOptional

Industry the account operates in

founded_yearinteger · int32Optional

Year the account was founded

raised_amountnumber · doubleOptional

Total amount raised by the account

employees_countinteger · int32Optional

Number of employees in the account

active_usersinteger · int32Optional

Number of active users

activities_countinteger · int32Optional

Number of activities

422

Client error

application/json

get

/lookup/accounts

HTTPcURLJavaScriptPython

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 person by identifiers

get

https://madapi.madkudu.comhttps://madapi.wisekudu.com

/lookup/persons

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.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

emailstringOptional

Person's email address

linkedinstringOptional

LinkedIn profile handle (e.g., 'in/francisbrero')

twitterstringOptional

Twitter profile handle

external_idstringOptional

Your CRM contact ID (Salesforce Lead/Contact, HubSpot Contact, etc.)

Responses

200

The request has succeeded.

application/json

mk_idstringRequired

Unique identifier for the person in MadKudu

emailstringRequired

Email of the person

namestringRequired

Full name of the person

first_namestringOptional

First name of the person

last_namestringOptional

Last name of the person

titlestringOptional

Title of the person

personastringOptional

Persona of the person

avatarstringOptional

Avatar URL of the person

has_left_companybooleanOptional

Whether the person has left the company

activitiesanyOptional

Activities information

422

Client error

application/json

get

/lookup/persons

HTTPcURLJavaScriptPython

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
  }
]