Search

Search accounts or persons with filters

Search accounts

post

/search/accounts

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

x-api-keystringRequired

Body

limitinteger · int32Optional

Number of results to return

cursorinteger · int32Optional

Cursor for pagination

searchstringOptional

Search query

filterLogicstring · enumOptionalPossible values:

Responses

200

The request has succeeded.

application/json

422

Client error

application/json

post/search/accounts

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

{
  "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/persons

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

x-api-keystringRequired

Body

limitinteger · int32Optional

Number of results to return

cursorinteger · int32Optional

Cursor for pagination

searchstringOptional

Search query

filterLogicstring · enumOptionalPossible values:

Responses

200

The request has succeeded.

application/json

422

Client error

application/json

post/search/persons

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

{
  "data": [
    {
      "mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
      "source_system": {
        "id": "00Q1K000011Oac0UAC",
        "system": "salesforce",
        "object": "Lead"
      },
      "email": "[e-mail]",
      "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
  }
}