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

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

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