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

Last updated

Was this helpful?