v4
latestOpenAPI 3.1.02026-08-012281296.0 MBAgentic search
Parse natural language to search params
Parses a natural language query into structured search parameters without executing the search.
Use the returned suggestedAction to determine your next step:
- combinedSearch: pass parsedParams.companySearchParams and parsedParams.profileSearchParams to POST /v1/combined-search/paginated
- companySearch: pass parsedParams.companySearchParams to POST /v1/company-search
- profileSearch: pass parsedParams.profileSearchParams to POST /v1/combined-search/paginated (with only profileConfig)
- personLookup: use the parsedParams.persons array with POST /v1/person-lookup/enrich (one call per person)
- companyLookup: use the parsedParams.companies array with POST /v1/company-lookup/enrich (one call per company)
- none: query could not be interpreted
Alternatively, use POST /v1/nlp-search/run to parse and execute in a single call.
<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>
<span>💰 <strong>Cost:</strong> 2 credits per request <span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>
post/v1/nlp-search/parse
Request body
Response
Default Response