Sourcing

Discover new prospects from your favorite data providers (Apollo, Cognism, and ZoomInfo), who aren't already in your CRM

You define who you're looking for based on criteria like company domain, job title, location, and seniority level. We go fetch them for you with the Discover endpoint. Then use the Enrich endpoints for the ones you're interested in to get their email, phone numbers and other contact details.

Pre-requisite: you must have your Apollo, ZoomInfo or Cognism account connected to your MadKudu workspace (see how to connect here)

Get available sourcing providers

get

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

/sourcing/providers

Retrieves a list of all available sourcing data providers and their connection status for the current tenant.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Responses

200

The request has succeeded.

application/json

providerstring · enumRequired

The name of the sourcing provider

Possible values:

isConnectedbooleanRequired

Whether the provider is properly configured and connected for this tenant

get

/sourcing/providers

HTTPcURLJavaScriptPython

GET /sourcing/providers HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*

200

The request has succeeded.

[
  {
    "provider": "apollo",
    "isConnected": true
  },
  {
    "provider": "zoominfo",
    "isConnected": false
  },
  {
    "provider": "cognism",
    "isConnected": false
  }
]

Discover persons using data providers

post

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

/sourcing/persons/discover

Discovers persons using various data providers with optional filtering criteria including company domain, job title, location, and seniority level.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

or

or

Responses

200

The request has succeeded.

application/json

post

/sourcing/persons/discover

HTTPcURLJavaScriptPython

POST /sourcing/persons/discover HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "provider": "zoominfo",
  "filters": {
    "jobTitle": "Software Engineer",
    "companyName": "Google"
  },
  "pagination": {
    "page": 1,
    "size": 25
  }
}

ZoomInfo with basic filtersCognism with cursor paginationApollo with comprehensive filtersApollo with location filter and pagination

200

The request has succeeded.

{
  "data": [
    {
      "id": "54a76bc77468696220a12433",
      "first_name": "Daniel",
      "last_name": "Smith",
      "photo": "https://media.licdn.com/dms/image/v2/D4D03AQFPn_aS6DPjOw/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1688475574243?e=2147483647&v=beta&t=EV-T1X8hhh7Aoz3nu3uLAJVoJU_m2ZlRWEJ7s3Gq0r8",
      "title": "CEO y Profesor de Inglés",
      "company_name": "Daniel Smith + Partners",
      "company_domain": "danielsmith.es",
      "linkedin_url": "http://www.linkedin.com/in/danielsmithpartners",
      "provider": "apollo"
    },
    {
      "id": "63e0c9c1cb02930001eb979e",
      "first_name": "Alberto",
      "last_name": "Sanroman Zamora",
      "photo": "https://media.licdn.com/dms/image/v2/D4D03AQEBda2tNkzzDA/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1676283506800?e=2147483647&v=beta&t=WfEfchr75yzltJ0qY3bZkWq5AbCvj8Sh1MhPb1l0KCM",
      "title": "Country Manager Iberia, MSS",
      "company_name": "Canadian Solar Inc.",
      "company_domain": "canadiansolar.com",
      "linkedin_url": "http://www.linkedin.com/in/alberto-sanrom%c3%a1n-zamora-bbb9b419",
      "provider": "apollo"
    }
  ],
  "pagination": {
    "next_page": 2,
    "page": 1,
    "size": 5,
    "total": 566819
  }
}

Enrich person with contact information

post

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

/sourcing/persons/enrich

Enriches an existing person record with additional contact information (email and phone) using the specified data provider and provider-specific ID.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

providerstring · enumRequired

Data provider to use

Possible values:

provider_idstringRequired

Provider-specific identifier for the person to enrich

Responses

200

The request has succeeded.

application/json

idstringRequired

Provider-specific person ID

first_namestringRequired

First name

last_namestringRequired

Last name

emailstringOptional

Email address (available after enrichment)

phonestringOptional

Phone number (available after enrichment)

photostringOptional

Photo URL

titlestringOptional

Job title

company_namestringOptional

Company name

company_domainstringOptional

Company domain

linkedin_urlstringOptional

LinkedIn profile URL

providerstring · enumRequired

Data provider used

Possible values:

enrich_tokenstringOptional

Token for enrichment (optional)

post

/sourcing/persons/enrich

HTTPcURLJavaScriptPython

POST /sourcing/persons/enrich HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "provider": "cognism",
  "provider_id": "xyz789abc123"
}

Enrich person with CognismEnrich person with Apollo

200

The request has succeeded.

{
  "id": "54a4c86a7468692fa2095563",
  "first_name": "Fuencisla",
  "last_name": "Clemares",
  "email": "fclem****@google.com",
  "phone": "+1 650-***-0000",
  "photo": "https://media.licdn.com/dms/image/v2/C4D03AQFzW_dW-LAHpg/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1562862813909?e=2147483647&v=beta&t=gXt7ElNgFjLg6gBmpyK1JCK4F4w6Q5_gd1PWLZu8QO8",
  "title": "VP EMEA GTM (Go To Market)",
  "company_domain": "google.com",
  "company_name": "Google",
  "linkedin_url": "http://www.linkedin.com/in/fuencisla-clemares-34527318",
  "provider": "apollo"
}