Target Screening

curl --request POST \
  --url https://api.wokelo.ai/api/enterprise/target-screening/enrich/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company": "microsoft",
  "parameters": {
    "detailed_query": "Looking for B2B SaaS companies in the cybersecurity space",
    "keywords": [
      "zero trust",
      "endpoint security"
    ],
    "sample_companies": [
      "crowdstrike",
      "sentinelone"
    ],
    "geography": [
      "USA"
    ],
    "company_type": "private",
    "employee_count": [],
    "founded_year": {},
    "funding_stage": [],
    "total_funding": {},
    "revenue": {}
  }
}
'

import requests

url = "https://api.wokelo.ai/api/enterprise/target-screening/enrich/"

payload = {
    "company": "microsoft",
    "parameters": {
        "detailed_query": "Looking for B2B SaaS companies in the cybersecurity space",
        "keywords": ["zero trust", "endpoint security"],
        "sample_companies": ["crowdstrike", "sentinelone"],
        "geography": ["USA"],
        "company_type": "private",
        "employee_count": [],
        "founded_year": {},
        "funding_stage": [],
        "total_funding": {},
        "revenue": {}
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    company: 'microsoft',
    parameters: {
      detailed_query: 'Looking for B2B SaaS companies in the cybersecurity space',
      keywords: ['zero trust', 'endpoint security'],
      sample_companies: ['crowdstrike', 'sentinelone'],
      geography: ['USA'],
      company_type: 'private',
      employee_count: [],
      founded_year: {},
      funding_stage: [],
      total_funding: {},
      revenue: {}
    }
  })
};

fetch('https://api.wokelo.ai/api/enterprise/target-screening/enrich/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.wokelo.ai/api/enterprise/target-screening/enrich/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'company' => 'microsoft',
    'parameters' => [
        'detailed_query' => 'Looking for B2B SaaS companies in the cybersecurity space',
        'keywords' => [
                'zero trust',
                'endpoint security'
        ],
        'sample_companies' => [
                'crowdstrike',
                'sentinelone'
        ],
        'geography' => [
                'USA'
        ],
        'company_type' => 'private',
        'employee_count' => [
                
        ],
        'founded_year' => [
                
        ],
        'funding_stage' => [
                
        ],
        'total_funding' => [
                
        ],
        'revenue' => [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.wokelo.ai/api/enterprise/target-screening/enrich/"

	payload := strings.NewReader("{\n  \"company\": \"microsoft\",\n  \"parameters\": {\n    \"detailed_query\": \"Looking for B2B SaaS companies in the cybersecurity space\",\n    \"keywords\": [\n      \"zero trust\",\n      \"endpoint security\"\n    ],\n    \"sample_companies\": [\n      \"crowdstrike\",\n      \"sentinelone\"\n    ],\n    \"geography\": [\n      \"USA\"\n    ],\n    \"company_type\": \"private\",\n    \"employee_count\": [],\n    \"founded_year\": {},\n    \"funding_stage\": [],\n    \"total_funding\": {},\n    \"revenue\": {}\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.wokelo.ai/api/enterprise/target-screening/enrich/")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"company\": \"microsoft\",\n  \"parameters\": {\n    \"detailed_query\": \"Looking for B2B SaaS companies in the cybersecurity space\",\n    \"keywords\": [\n      \"zero trust\",\n      \"endpoint security\"\n    ],\n    \"sample_companies\": [\n      \"crowdstrike\",\n      \"sentinelone\"\n    ],\n    \"geography\": [\n      \"USA\"\n    ],\n    \"company_type\": \"private\",\n    \"employee_count\": [],\n    \"founded_year\": {},\n    \"funding_stage\": [],\n    \"total_funding\": {},\n    \"revenue\": {}\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.wokelo.ai/api/enterprise/target-screening/enrich/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"company\": \"microsoft\",\n  \"parameters\": {\n    \"detailed_query\": \"Looking for B2B SaaS companies in the cybersecurity space\",\n    \"keywords\": [\n      \"zero trust\",\n      \"endpoint security\"\n    ],\n    \"sample_companies\": [\n      \"crowdstrike\",\n      \"sentinelone\"\n    ],\n    \"geography\": [\n      \"USA\"\n    ],\n    \"company_type\": \"private\",\n    \"employee_count\": [],\n    \"founded_year\": {},\n    \"funding_stage\": [],\n    \"total_funding\": {},\n    \"revenue\": {}\n  }\n}"

response = http.request(request)
puts response.read_body

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

POST

api

enterprise

target-screening

enrich

Target Screening

curl --request POST \
  --url https://api.wokelo.ai/api/enterprise/target-screening/enrich/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company": "microsoft",
  "parameters": {
    "detailed_query": "Looking for B2B SaaS companies in the cybersecurity space",
    "keywords": [
      "zero trust",
      "endpoint security"
    ],
    "sample_companies": [
      "crowdstrike",
      "sentinelone"
    ],
    "geography": [
      "USA"
    ],
    "company_type": "private",
    "employee_count": [],
    "founded_year": {},
    "funding_stage": [],
    "total_funding": {},
    "revenue": {}
  }
}
'

import requests

url = "https://api.wokelo.ai/api/enterprise/target-screening/enrich/"

payload = {
    "company": "microsoft",
    "parameters": {
        "detailed_query": "Looking for B2B SaaS companies in the cybersecurity space",
        "keywords": ["zero trust", "endpoint security"],
        "sample_companies": ["crowdstrike", "sentinelone"],
        "geography": ["USA"],
        "company_type": "private",
        "employee_count": [],
        "founded_year": {},
        "funding_stage": [],
        "total_funding": {},
        "revenue": {}
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    company: 'microsoft',
    parameters: {
      detailed_query: 'Looking for B2B SaaS companies in the cybersecurity space',
      keywords: ['zero trust', 'endpoint security'],
      sample_companies: ['crowdstrike', 'sentinelone'],
      geography: ['USA'],
      company_type: 'private',
      employee_count: [],
      founded_year: {},
      funding_stage: [],
      total_funding: {},
      revenue: {}
    }
  })
};

fetch('https://api.wokelo.ai/api/enterprise/target-screening/enrich/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.wokelo.ai/api/enterprise/target-screening/enrich/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'company' => 'microsoft',
    'parameters' => [
        'detailed_query' => 'Looking for B2B SaaS companies in the cybersecurity space',
        'keywords' => [
                'zero trust',
                'endpoint security'
        ],
        'sample_companies' => [
                'crowdstrike',
                'sentinelone'
        ],
        'geography' => [
                'USA'
        ],
        'company_type' => 'private',
        'employee_count' => [
                
        ],
        'founded_year' => [
                
        ],
        'funding_stage' => [
                
        ],
        'total_funding' => [
                
        ],
        'revenue' => [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.wokelo.ai/api/enterprise/target-screening/enrich/"

	payload := strings.NewReader("{\n  \"company\": \"microsoft\",\n  \"parameters\": {\n    \"detailed_query\": \"Looking for B2B SaaS companies in the cybersecurity space\",\n    \"keywords\": [\n      \"zero trust\",\n      \"endpoint security\"\n    ],\n    \"sample_companies\": [\n      \"crowdstrike\",\n      \"sentinelone\"\n    ],\n    \"geography\": [\n      \"USA\"\n    ],\n    \"company_type\": \"private\",\n    \"employee_count\": [],\n    \"founded_year\": {},\n    \"funding_stage\": [],\n    \"total_funding\": {},\n    \"revenue\": {}\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.wokelo.ai/api/enterprise/target-screening/enrich/")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"company\": \"microsoft\",\n  \"parameters\": {\n    \"detailed_query\": \"Looking for B2B SaaS companies in the cybersecurity space\",\n    \"keywords\": [\n      \"zero trust\",\n      \"endpoint security\"\n    ],\n    \"sample_companies\": [\n      \"crowdstrike\",\n      \"sentinelone\"\n    ],\n    \"geography\": [\n      \"USA\"\n    ],\n    \"company_type\": \"private\",\n    \"employee_count\": [],\n    \"founded_year\": {},\n    \"funding_stage\": [],\n    \"total_funding\": {},\n    \"revenue\": {}\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.wokelo.ai/api/enterprise/target-screening/enrich/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"company\": \"microsoft\",\n  \"parameters\": {\n    \"detailed_query\": \"Looking for B2B SaaS companies in the cybersecurity space\",\n    \"keywords\": [\n      \"zero trust\",\n      \"endpoint security\"\n    ],\n    \"sample_companies\": [\n      \"crowdstrike\",\n      \"sentinelone\"\n    ],\n    \"geography\": [\n      \"USA\"\n    ],\n    \"company_type\": \"private\",\n    \"employee_count\": [],\n    \"founded_year\": {},\n    \"funding_stage\": [],\n    \"total_funding\": {},\n    \"revenue\": {}\n  }\n}"

response = http.request(request)
puts response.read_body

{
    "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 response.

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

string

required

JWT token obtained from the Authentication request

Body Parameters

string

required

Permalink of the acquiring company or complete URL (e.g. "microsoft" OR "https://www.microsoft.com/")

object

Filter parameters object. All fields inside are optional, but must always be included in the request body — send empty values ("", [], {}) for any fields you do not want to filter on.

string

A descriptive query to refine the target search scope.

string[]

Keywords used to identify and filter relevant target companies.

string[]

Permalinks of representative companies to anchor the target search.

string[]

Geographic scope as ISO country codes. (e.g. ["USA", "GBR"])

string

Type of company to include. Accepted values: "private", "public", "all"

string[]

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+

object

Filter by company founding year.

integer

Minimum founding year (inclusive), e.g. 2010

integer

Maximum founding year (inclusive), e.g. 2020

string[]

Filter by funding stage. 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

object

Filter by total funding amount raised (in USD).

number

Minimum total funding in USD, e.g. 1000000

number

Maximum total funding in USD, e.g. 50000000

object

Filter by annual revenue (in USD).

number

Minimum annual revenue in USD, e.g. 500000

number

Maximum annual revenue in USD, e.g. 10000000

Response

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

Successful Response Fields

string

Unique identifier for the request posted. Use this with the /api/enterprise/request/status/ endpoint to check the status

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

Authorizations

Authorization

string

header

required

JWT token obtained from the /auth/token/ endpoint.

Body

application/json

company

string

required

Permalink or URL of the acquiring company.

Example:

"microsoft"

parameters

object

Optional filter parameters. All fields must always be included in the request body — send empty values for any fields you do not want to filter on.

Show child attributes

Response

202 - application/json

Request accepted

request_id

string<uuid>

Example:

"931643e9-b6c7-45d4-9ba9-bd3b534221e7"

status

enum<string>

Available options:

PENDING,

PROCESSING,

COMPLETED,

FAILED

Example:

"PENDING"

Discovery

Workflow automation

Supporting APIs

Target Screening

Overview

Endpoint Details

Authentication Requirements

Request

Header Parameters

Body Parameters

Response

Successful Response Fields

Authorizations

Body

Response

​Overview

​Endpoint Details

​Authentication Requirements

​Request

​Header Parameters

​Body Parameters

​Response

​Successful Response Fields

Authorizations

Body

Response

Overview

Endpoint Details

Authentication Requirements

Request

Header Parameters

Body Parameters

Response

Successful Response Fields