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

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.

Authorizations
Query parameters
domainstringOptional

Domain of the account to look up

linkedinstringOptional

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

twitterstringOptional

Twitter handle

crunchbasestringOptional

Crunchbase organization handle with prefix (e.g., 'organization/madkudu')

external_idstringOptional

External CRM ID (e.g., Salesforce Account ID, HubSpot Account ID)

Responses
200
The request has succeeded.
application/json
get
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

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.

Authorizations
Query parameters
emailstringOptional

Email address of the person

linkedinstringOptional

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

twitterstringOptional

Twitter handle

external_idstringOptional

External CRM ID (e.g., Salesforce Lead/Contact ID, HubSpot Contact ID)

Responses
200
The request has succeeded.
application/json
get
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?