Search

Search accounts or persons with filters

Search accounts

post

Search for accounts with advanced filtering capabilities. Supports filtering by company attributes like domain, name, industry, employee count, funding, location, and activity levels. Includes pagination, sorting, and full-text search.

Authorizations

Body

limitinteger · int32Optional

Number of results to return

cursorinteger · int32Optional

Cursor for pagination

searchstringOptional

Search query

filterLogicall ofOptional

Filter logic

string · enumOptionalPossible values:

Responses

200

The request has succeeded.

application/json

422

Client error

application/json

post

HTTPcURLJavaScriptPython

POST /search/accounts HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 321

{
  "limit": 15,
  "search": "artificial intelligence",
  "filters": [
    {
      "property": "industry",
      "operator": "CONTAINS",
      "value": "AI"
    },
    {
      "property": "employees_count",
      "operator": "BETWEEN",
      "value": [
        50,
        500
      ]
    },
    {
      "property": "founded_year",
      "operator": "GTE",
      "value": 2018
    }
  ],
  "filterLogic": "AND",
  "sort": [
    {
      "sort_by": "founded_year",
      "sort_order": "desc"
    }
  ]
}

Find AI startups founded since 2018Basic search for fintech companies

{
  "data": [
    {
      "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": 48,
      "activities_count": 434415,
      "socials": {
        "linkedin_handle": "company/madkudu",
        "twitter_handle": "madkudu",
        "crunchbase_handle": "organization/madkudu",
        "website": "https://madkudu.com"
      },
      "location": {
        "country": "United States",
        "city": "Mountain View"
      },
      "scores": {
        "customer_fit": {
          "score": 49,
          "segment": "low",
          "signals": "✅ Company likely using Salesforce \n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52"
        },
        "likelihood_to_buy": {
          "score": 100,
          "segment": "very high"
        }
      }
    }
  ],
  "meta": {
    "limit": 10,
    "total": 1,
    "has_next_page": false,
    "next_cursor": 10
  }
}

Search persons

post

Search for persons with advanced filtering capabilities. Supports filtering by personal attributes like email, name, title, persona, company domain, location, and activity levels. Includes pagination, sorting, and full-text search.

Authorizations

Body

limitinteger · int32Optional

Number of results to return

cursorinteger · int32Optional

Cursor for pagination

searchstringOptional

Search query

filterLogicall ofOptional

Filter logic

string · enumOptionalPossible values:

Responses

200

The request has succeeded.

application/json

422

Client error

application/json

post

HTTPcURLJavaScriptPython

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

{
  "limit": 25,
  "filters": [
    {
      "property": "persona",
      "operator": "CONTAINS",
      "value": "Developer"
    },
    {
      "property": "title",
      "operator": "CONTAINS",
      "value": "Senior"
    },
    {
      "property": "country",
      "operator": "IN",
      "value": [
        "United States",
        "Canada",
        "United Kingdom"
      ]
    },
    {
      "property": "has_left_company",
      "operator": "IS",
      "value": false
    }
  ],
  "filterLogic": "AND",
  "sort": [
    {
      "sort_by": "name",
      "sort_order": "asc"
    }
  ]
}

Target senior developers currently employed in English-speaking countriesFind active founders at non-FAANG companiesBasic search

{
  "data": [
    {
      "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": "",
        "crunchbase_handle": "",
        "website": ""
      },
      "location": {
        "country": "United States",
        "state": "California",
        "city": "Mountain View"
      },
      "has_left_company": false,
      "scores": {
        "customer_fit": {
          "score": 49,
          "segment": "low",
          "signals": "✅ Company likely using Salesforce \n✅ Title is Co-founder\n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52"
        },
        "likelihood_to_buy": {
          "score": 96,
          "segment": "very high"
        }
      },
      "activities": 11974
    }
  ],
  "meta": {
    "limit": 10,
    "total": 1,
    "has_next_page": false,
    "next_cursor": 10
  }
}