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

const raw = JSON.stringify({
  "company": "acme-security",
  "parameters": {
    "detailed_query": "Looking for strategic acquirers in enterprise software",
    "buyer_type": [
      "strategic"
    ],
    "company_type": "public",
    "geography": [
      "United States"
    ]
  }
});

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

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

{
    "request_id": "278412f8-87ca-47a9-9d1c-4a62a687eaf6",
    "status": "PENDING"
}

​
Overview

The Buyer Screening API generates a long list of potential buyers for a given target company, enriched with structured data. Optionally, you can refine the output by specifying buyer type, company type, geography, and a detailed query to narrow the strategic criteria. Returns a request_id as a response.

​
Endpoint Details

  • Method: POST
  • Endpoint: /api/enterprise/buyer-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

​
company
string
required
Permalink of the target company or its complete URLExample: "acme-solar" OR https://www.acmesolar.in/
​
parameters.detailed_query
string
A descriptive query to refine the buyer search scope and strategic criteria
​
parameters.buyer_type
array
Type of buyer to target. Accepted values: "strategic", "financial"
​
parameters.company_type
string
Type of company to include. Accepted values: "private", "public", "all"
​
parameters.geography
array of strings
Geographic scope. It should be a comma separated list of ISO country codes. (Eg.. ["USA", "GBR"])

​
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": "acme-security",
  "parameters": {
    "detailed_query": "Looking for strategic acquirers in enterprise software",
    "buyer_type": [
      "strategic"
    ],
    "company_type": "public",
    "geography": [
      "United States"
    ]
  }
});

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

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

{
    "request_id": "278412f8-87ca-47a9-9d1c-4a62a687eaf6",
    "status": "PENDING"
}