Skip to main content
POST
/
api
/
enterprise
/
target-screening
/
enrich
const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer Token");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "company": "microsoft",
  "parameters": {
    "detailed_query": "Looking for B2B SaaS companies in the cybersecurity space",
    "keywords": ["zero trust", "endpoint security"],
    "sample_companies": ["crowdstrike", "sentinel"],
    "geography": ["United States"],
    "company_type": "private",
    "employee_count": [],
    "founded_year": {},
    "funding_stage": [],
    "total_funding": {},
    "revenue": {}
  }
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("{{path}}/api/enterprise/target-screening/enrich/", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

{
    "request_id": "8583f59e-0412-4f1e-81e5-13cc70349cb6",
    "status": "PENDING"
}

​
Overview

The Target Screening API generates a long list of potential acquisition targets for a given acquirer, enriched with structured data. Optionally, you can refine the output by specifying keywords, sample companies, geography, company type, employee count, funding stage, and a detailed query to narrow the search scope. Returns a request_id as a reponse.

​
Endpoint Details

  • Method: POST
  • Endpoint: /api/enterprise/target-screening/enrich/

​
Authentication Requirements

  • Include a valid JWT token in your request header
  • If you don’t have a token yet, you can get one from the /auth/token/ endpoint first.

​
Request

​
Header Parameters

​
token
string
required
JWT token obtained from the Authentication request

​
Body Parameters

​
topic
string
Industry/ product domain. Default will be the product category of the acquiring company.
​
company
string
required
Permalink of the acquiring company or complete URL (e.g. "microsoft" OR "https://www.microsoft.com/")
​
parameters.detailed_query
string
A descriptive query to refine the target search scope.
​
parameters.keywords
array of strings
Keywords used to identify and filter relevant target companies
​
parameters.sample_companies
array of strings
Permalinks of representative companies to anchor the target search
​
parameters.geography
array of strings
Geographic scope. It should be a comma separated list of ISO country codes. (Eg.. ["USA", "GBR"])
​
parameters.company_type
string
Type of company to include. Accepted values: "private", "public", "all"
​
parameters.employee_count
array of strings
Filter by employee headcount range. Pass an empty array to include all headcounts.Supporting array values: 1-10, 11-50, 51-100, 101-250, 251-500, 501-1000, 1001-5000, 5001-10000, 10000+
​
parameters.founded_year
object
Filter by company founding year. Accepts from and/or to integer values
​
parameters.funding_stage
array of strings
Filter by funding stage (e.g. "Series B", "Series C"). Pass an empty array to include all stages.Supporting array values: Non-Equity Assistance, Angel round, Pre-seed, Seed, Series A, Series B, Series C, Series D, Series E, Series F, Series G, Series H, Series I, Series J, Corporate-Funded, Debt-Funded, Private equity round, Others
​
parameters.total_funding
object
Filter by total funding amount raised (in USD). Accepts from and/or to values
​
parameters.revenue
object
Filter by annual revenue (in USD). Accepts from and/or to values

​
Response

A successful response returns a request_id that can be used to track the status of the request.

​
Successful Response Fields

​
request_id
string
Unique identifier for the request posted. Use this with the /api/enterprise/request/status/ endpoint to check the status
const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer Token");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "company": "microsoft",
  "parameters": {
    "detailed_query": "Looking for B2B SaaS companies in the cybersecurity space",
    "keywords": ["zero trust", "endpoint security"],
    "sample_companies": ["crowdstrike", "sentinel"],
    "geography": ["United States"],
    "company_type": "private",
    "employee_count": [],
    "founded_year": {},
    "funding_stage": [],
    "total_funding": {},
    "revenue": {}
  }
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("{{path}}/api/enterprise/target-screening/enrich/", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

{
    "request_id": "8583f59e-0412-4f1e-81e5-13cc70349cb6",
    "status": "PENDING"
}