Overview
This endpoint triggers an asynchronous AI-powered process that discovers companies based on your search criteria.Workflow Step: This is Step 2 of the Market Research
Workflow.
Important: This is an asynchronous process that can take 5-15 minutes to complete. Use the status endpoint to
monitor progress.
Usage
The endpoint accepts search criteria and pipeline configuration options to control the discovery process:- Search Criteria: Market definition, keywords, and constraints
- Pipeline Choices: Configuration for different analysis steps
- Response: Job IDs for monitoring progress
Pipeline Configuration: Choose pipeline steps based on your research goals. Each step adds valuable insights but
increases processing time.
Monitoring Progress
After starting discovery, monitor progress using the Get Discovery Job Status endpoint:Polling Strategy: Check status every 30-60 seconds. The process typically takes 5-15 minutes depending on search
complexity.
Best Practices
For Better Results: Use clear and specific search criteria generated from the
Generate Search Criteria endpoint.
Well-defined criteria help the discovery process return more relevant companies.
Important: Only one discovery process can run for a given market at a time. If you attempt to start discovery
multiple times for the same market while a process is already running, your request will not succeed.
Authorizations
Pass a static API key for every request, provided by your customer support.
Body
application/json