Search

Search accounts or persons with filters

Search accounts

post

Search for accounts by domain, name, or social media handles. Supports pagination, filtering, and sorting.

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: 183

{
  "limit": 10,
  "cursor": 0,
  "search": "madkudu",
  "filters": [
    {
      "property": "domain",
      "operator": "CONTAINS",
      "value": "madkudu"
    }
  ],
  "filterLogic": "AND",
  "sort": [
    {
      "sort_by": "name",
      "sort_order": "asc"
    }
  ]
}

{
  "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 by email, name, or social media handles. Supports pagination, filtering, and sorting.

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: 182

{
  "limit": 10,
  "cursor": 0,
  "search": "francis",
  "filters": [
    {
      "property": "title",
      "operator": "CONTAINS",
      "value": "founder"
    }
  ],
  "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": "[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
  }
}