# Search

## 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.

```json
{"openapi":"3.1.0","info":{"title":"MadAPI","version":"0.0.0"},"tags":[{"name":"Search"}],"servers":[{"url":"https://madapi.madkudu.com","description":"Production server","variables":{}},{"url":"https://madapi.wisekudu.com","description":"Staging server","variables":{}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"AccountSearchResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AccountDetailSearch"},"description":"Account search data"},"meta":{"allOf":[{"$ref":"#/components/schemas/Common.Models.Meta"}],"description":"Metadata"}}},"AccountDetailSearch":{"type":"object","required":["mk_id","source_system","name","domain","socials","location","scores"],"properties":{"mk_id":{"type":"string","description":"Unique identifier for the account in MadKudu"},"source_system":{"allOf":[{"$ref":"#/components/schemas/Common.Models.SourceSystem"}],"description":"Source system information"},"name":{"type":"string","description":"Account name"},"domain":{"type":"string","description":"Account domain"},"logo":{"type":"string","description":"Logo URL"},"description":{"type":"string","description":"Account description"},"industry":{"type":"string","description":"Industry"},"founded_year":{"type":"integer","format":"int32","description":"Founded year"},"raised_amount":{"type":"number","format":"double","description":"Raised amount"},"employees_count":{"type":"integer","format":"int32","description":"Number of employees"},"active_users":{"type":"integer","format":"int32","description":"Number of active users"},"activities_count":{"type":"integer","format":"int32","description":"Total activities count"},"socials":{"allOf":[{"$ref":"#/components/schemas/Common.Models.AccountSocials"}],"description":"Social media handles"},"location":{"allOf":[{"$ref":"#/components/schemas/Common.Models.Location"}],"description":"Location information"},"scores":{"allOf":[{"$ref":"#/components/schemas/Common.Models.Scores"}],"description":"Scoring information"}}},"Common.Models.SourceSystem":{"type":"object","required":["id","system","object"],"properties":{"id":{"type":"string","description":"Unique identifier in the source system"},"system":{"type":"string","description":"Name of the source system"},"object":{"type":"string","description":"Object type in the source system"}}},"Common.Models.AccountSocials":{"type":"object","properties":{"linkedin_handle":{"type":"string","description":"LinkedIn company handle"},"twitter_handle":{"type":"string","description":"Twitter company handle"},"crunchbase_handle":{"type":"string","description":"Crunchbase organization handle"},"website":{"type":"string","description":"Company website URL"}}},"Common.Models.Location":{"type":"object","properties":{"country":{"type":"string","description":"Country"},"state":{"type":"string","description":"State or region"},"city":{"type":"string","description":"City"}}},"Common.Models.Scores":{"type":"object","required":["customer_fit","likelihood_to_buy"],"properties":{"customer_fit":{"allOf":[{"$ref":"#/components/schemas/Common.Models.CustomerFit"}],"description":"Customer fit information"},"likelihood_to_buy":{"allOf":[{"$ref":"#/components/schemas/Common.Models.LikelihoodToBuy"}],"description":"Likelihood to buy information"}}},"Common.Models.CustomerFit":{"type":"object","required":["score","segment"],"properties":{"score":{"type":"number","format":"double","description":"Customer fit score"},"segment":{"type":"string","description":"Customer fit segment"},"signals":{"type":"string","description":"Customer fit signals"}}},"Common.Models.LikelihoodToBuy":{"type":"object","required":["score","segment"],"properties":{"score":{"type":"number","format":"double","description":"Likelihood to buy score"},"segment":{"type":"string","description":"Likelihood to buy segment"}}},"Common.Models.Meta":{"type":"object","properties":{"limit":{"type":"integer","format":"int32","description":"Number of results returned"},"total":{"type":"integer","format":"int32","description":"Total number of results available"},"has_next_page":{"type":"boolean","description":"Whether there are more results"},"next_cursor":{"type":"integer","format":"int32","description":"Next cursor for pagination"}}},"Common.Errors.ValidationError":{"type":"object","required":["detail"],"properties":{"detail":{"type":"array","items":{"type":"object","properties":{"loc":{"type":"array","prefixItems":[{"anyOf":[{"type":"string"},{"type":"integer","format":"int32"}]}],"description":"What part is invalid"},"msg":{"type":"string","description":"Message discribing the error"},"type":{"type":"string","description":"Type of the error"},"input":{},"ctx":{}},"required":["loc","msg","type"]}}},"description":"Error return when body sent is invalid"},"AccountSearchRequest":{"type":"object","properties":{"limit":{"type":"integer","format":"int32","description":"Number of results to return"},"cursor":{"type":"integer","format":"int32","description":"Cursor for pagination"},"search":{"type":"string","description":"Search query"},"filters":{"type":"array","items":{"$ref":"#/components/schemas/AccountSearchFilter"},"description":"Filters to apply - restricted to account fields"},"filterLogic":{"allOf":[{"$ref":"#/components/schemas/FilterLogic"}],"description":"Filter logic"},"sort":{"type":"array","items":{"$ref":"#/components/schemas/Common.Models.SortingParam"},"description":"Sorting parameters"}}},"AccountSearchFilter":{"type":"object","required":["property","operator","value"],"properties":{"property":{"type":"string","enum":["name","domain","industry","employees_count","founded_year","raised_amount","country","city","active_users","activities_count"],"description":"Property to filter by - restricted to account fields"},"operator":{"allOf":[{"$ref":"#/components/schemas/FilterOperator"}],"description":"Filter operator"},"value":{"anyOf":[{"type":"string"},{"type":"integer","format":"int32"},{"type":"number","format":"double"},{"type":"boolean"},{"type":"string","format":"date-time"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer","format":"int32"},{"type":"number","format":"double"},{"type":"boolean"},{"type":"string","format":"date-time"}]}}],"description":"Filter value"}}},"FilterOperator":{"type":"string","enum":["IS","IS_NOT","GT","GTE","LT","LTE","IN","NOT_IN","BETWEEN","NOT_BETWEEN","IS_NULL","IS_NOT_NULL","CONTAINS","NOT_CONTAINS","STARTS_WITH","ENDS_WITH"]},"FilterLogic":{"type":"string","enum":["AND","OR"]},"Common.Models.SortingParam":{"type":"object","required":["sort_by","sort_order"],"properties":{"sort_by":{"type":"string","description":"Field to sort by"},"sort_order":{"type":"string","enum":["asc","desc"],"description":"Sort order"}}}}},"paths":{"/search/accounts":{"post":{"operationId":"Search_searchAccounts","summary":"Search accounts","description":"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.","parameters":[],"responses":{"200":{"description":"The request has succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSearchResponse"}}}},"422":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Common.Errors.ValidationError"}}}}},"tags":["Search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSearchRequest"}}}}}}}}
```

## 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.

```json
{"openapi":"3.1.0","info":{"title":"MadAPI","version":"0.0.0"},"tags":[{"name":"Search"}],"servers":[{"url":"https://madapi.madkudu.com","description":"Production server","variables":{}},{"url":"https://madapi.wisekudu.com","description":"Staging server","variables":{}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"PersonSearchResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PersonDetailSearch"},"description":"Person search data"},"meta":{"allOf":[{"$ref":"#/components/schemas/Common.Models.Meta"}],"description":"Metadata"}}},"PersonDetailSearch":{"type":"object","required":["mk_id","source_system","email","name","company","socials","location","scores"],"properties":{"mk_id":{"type":"string","description":"Unique identifier for the person in MadKudu"},"source_system":{"allOf":[{"$ref":"#/components/schemas/Common.Models.SourceSystem"}],"description":"Source system information"},"email":{"type":"string","description":"Email address"},"name":{"type":"string","description":"Full name"},"first_name":{"type":"string","description":"First name"},"last_name":{"type":"string","description":"Last name"},"title":{"type":"string","description":"Job title"},"persona":{"type":"string","description":"Persona"},"avatar":{"type":"string","description":"Avatar URL"},"company":{"allOf":[{"$ref":"#/components/schemas/Common.Models.CompanyReference"}],"description":"Company information"},"socials":{"allOf":[{"$ref":"#/components/schemas/Common.Models.PersonSocials"}],"description":"Social media handles"},"location":{"allOf":[{"$ref":"#/components/schemas/Common.Models.Location"}],"description":"Location information"},"has_left_company":{"type":"boolean","description":"Has left company"},"scores":{"allOf":[{"$ref":"#/components/schemas/Common.Models.Scores"}],"description":"Scoring information"},"activities":{"description":"Activities information"}}},"Common.Models.SourceSystem":{"type":"object","required":["id","system","object"],"properties":{"id":{"type":"string","description":"Unique identifier in the source system"},"system":{"type":"string","description":"Name of the source system"},"object":{"type":"string","description":"Object type in the source system"}}},"Common.Models.CompanyReference":{"type":"object","required":["domain","mk_id"],"properties":{"domain":{"type":"string","description":"Domain of the company"},"mk_id":{"type":"string","description":"MadKudu ID of the company"}}},"Common.Models.PersonSocials":{"type":"object","properties":{"linkedin_handle":{"type":"string","description":"LinkedIn handle"},"twitter_handle":{"type":"string","description":"Twitter handle"},"crunchbase_handle":{"type":"string","description":"Crunchbase handle"},"website":{"type":"string","description":"Website URL"}}},"Common.Models.Location":{"type":"object","properties":{"country":{"type":"string","description":"Country"},"state":{"type":"string","description":"State or region"},"city":{"type":"string","description":"City"}}},"Common.Models.Scores":{"type":"object","required":["customer_fit","likelihood_to_buy"],"properties":{"customer_fit":{"allOf":[{"$ref":"#/components/schemas/Common.Models.CustomerFit"}],"description":"Customer fit information"},"likelihood_to_buy":{"allOf":[{"$ref":"#/components/schemas/Common.Models.LikelihoodToBuy"}],"description":"Likelihood to buy information"}}},"Common.Models.CustomerFit":{"type":"object","required":["score","segment"],"properties":{"score":{"type":"number","format":"double","description":"Customer fit score"},"segment":{"type":"string","description":"Customer fit segment"},"signals":{"type":"string","description":"Customer fit signals"}}},"Common.Models.LikelihoodToBuy":{"type":"object","required":["score","segment"],"properties":{"score":{"type":"number","format":"double","description":"Likelihood to buy score"},"segment":{"type":"string","description":"Likelihood to buy segment"}}},"Common.Models.Meta":{"type":"object","properties":{"limit":{"type":"integer","format":"int32","description":"Number of results returned"},"total":{"type":"integer","format":"int32","description":"Total number of results available"},"has_next_page":{"type":"boolean","description":"Whether there are more results"},"next_cursor":{"type":"integer","format":"int32","description":"Next cursor for pagination"}}},"Common.Errors.ValidationError":{"type":"object","required":["detail"],"properties":{"detail":{"type":"array","items":{"type":"object","properties":{"loc":{"type":"array","prefixItems":[{"anyOf":[{"type":"string"},{"type":"integer","format":"int32"}]}],"description":"What part is invalid"},"msg":{"type":"string","description":"Message discribing the error"},"type":{"type":"string","description":"Type of the error"},"input":{},"ctx":{}},"required":["loc","msg","type"]}}},"description":"Error return when body sent is invalid"},"PersonSearchRequest":{"type":"object","properties":{"limit":{"type":"integer","format":"int32","description":"Number of results to return"},"cursor":{"type":"integer","format":"int32","description":"Cursor for pagination"},"search":{"type":"string","description":"Search query"},"filters":{"type":"array","items":{"$ref":"#/components/schemas/PersonSearchFilter"},"description":"Filters to apply - restricted to person fields"},"filterLogic":{"allOf":[{"$ref":"#/components/schemas/FilterLogic"}],"description":"Filter logic"},"sort":{"type":"array","items":{"$ref":"#/components/schemas/Common.Models.SortingParam"},"description":"Sorting parameters"}}},"PersonSearchFilter":{"type":"object","required":["property","operator","value"],"properties":{"property":{"type":"string","enum":["email","first_name","last_name","name","title","persona","company_domain","country","state","city","activities","has_left_company"],"description":"Property to filter by - restricted to person fields"},"operator":{"allOf":[{"$ref":"#/components/schemas/FilterOperator"}],"description":"Filter operator"},"value":{"anyOf":[{"type":"string"},{"type":"integer","format":"int32"},{"type":"number","format":"double"},{"type":"boolean"},{"type":"string","format":"date-time"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"integer","format":"int32"},{"type":"number","format":"double"},{"type":"boolean"},{"type":"string","format":"date-time"}]}}],"description":"Filter value"}}},"FilterOperator":{"type":"string","enum":["IS","IS_NOT","GT","GTE","LT","LTE","IN","NOT_IN","BETWEEN","NOT_BETWEEN","IS_NULL","IS_NOT_NULL","CONTAINS","NOT_CONTAINS","STARTS_WITH","ENDS_WITH"]},"FilterLogic":{"type":"string","enum":["AND","OR"]},"Common.Models.SortingParam":{"type":"object","required":["sort_by","sort_order"],"properties":{"sort_by":{"type":"string","description":"Field to sort by"},"sort_order":{"type":"string","enum":["asc","desc"],"description":"Sort order"}}}}},"paths":{"/search/persons":{"post":{"operationId":"Search_searchPersons","summary":"Search persons","description":"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.","parameters":[],"responses":{"200":{"description":"The request has succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonSearchResponse"}}}},"422":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Common.Errors.ValidationError"}}}}},"tags":["Search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonSearchRequest"}}}}}}}}
```