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

post

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
Body
domainstringOptional

Domain of the account to look up

mk_idstringOptional

Unique identifier for the account in MadKudu

linkedin_handlestringOptional

Unique identifier for the account in LinkedIn (including the prefixes)

twitter_handlestringOptional

Unique identifier for the account in Twitter

salesforce_idstringOptional

Unique identifier for the account in Salesforce

hubspot_idstringOptional

Unique identifier for the account in HubSpot

Responses
200
The request has succeeded.
application/json
post
POST /lookup/accounts HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "linkedin_handle": "company/madkudu"
}
[
  {
    "name": "MadKudu",
    "domain": "madkudu.com",
    "mk_id": "salesforce_Account_Id_0011K000027UadJQAS",
    "employees_count": 52,
    "founded_year": 2014,
    "customer_fit_score": 49,
    "customer_fit_segment": "low",
    "likelihood_to_buy_score": 100,
    "likelihood_to_buy_segment": "very high",
    "raised_amount": 27100000,
    "logo_url": "https://logo.clearbit.com/madkudu.com",
    "industry": "Internet Software & Services",
    "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",
    "website_url": "https://madkudu.com",
    "crunchbase_handle": "organization/madkudu",
    "linkedin_handle": "company/madkudu",
    "twitter_handle": "madkudu",
    "country": "United States",
    "city": "Mountain View",
    "salesforce_id": "0011K000027UadJQAS",
    "hubspot_id": ""
  }
]

Lookup person by identifiers

post

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
Body
emailstringOptional

Email of the person to look up

mk_idstringOptional

Unique identifier for the person in MadKudu

linkedin_handlestringOptional

Unique identifier for the person in LinkedIn (including the prefixes)

twitter_handlestringOptional

Unique identifier for the person in Twitter

salesforce_idstringOptional

Unique identifier for the person in Salesforce

hubspot_idstringOptional

Unique identifier for the person in HubSpot

Responses
200
The request has succeeded.
application/json
post
POST /lookup/persons HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "linkedin_handle": "in/francisbrero"
}
[
  {
    "email": "[email protected]",
    "mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
    "customer_fit_score": 49,
    "customer_fit_segment": "low",
    "likelihood_to_buy_score": 96,
    "likelihood_to_buy_segment": "very high",
    "city": "Mountain View",
    "country": "United States",
    "first_name": "Francis",
    "last_name": "Brero",
    "full_name": "Francis Brero",
    "persona": "",
    "avatar_url": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/50eb56e0-cc77-4468-a133-a685c8ed5715",
    "title": "Co-founder",
    "state": "California",
    "linkedin_handle": "in/francisbrero",
    "twitter_handle": "",
    "salesforce_id": "00Q1K000011Oac0UAC"
  }
]

Last updated

Was this helpful?