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

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

Authorizations

Responses

200

The request has succeeded.

application/json

get

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

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

Authorizations

Body

any ofOptional

or

or

Responses

200

The request has succeeded.

application/json

post

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

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

Authorizations

Body

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

post

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