V2 Businesses Lookalikes Enrich
curl --request POST \
--url https://api.explorium.ai/v2/businesses/lookalikes/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793"
]
}
'import requests
url = "https://api.explorium.ai/v2/businesses/lookalikes/enrich"
payload = { "business_ids": ["8adce3ca1cef0c986b22310e369a0793"] }
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({business_ids: ['8adce3ca1cef0c986b22310e369a0793']})
};
fetch('https://api.explorium.ai/v2/businesses/lookalikes/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.explorium.ai/v2/businesses/lookalikes/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([
'business_ids' => [
'8adce3ca1cef0c986b22310e369a0793'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$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.explorium.ai/v2/businesses/lookalikes/enrich"
payload := strings.NewReader("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
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.explorium.ai/v2/businesses/lookalikes/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/businesses/lookalikes/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"business_id": "<string>",
"data": {
"business_id": "<string>",
"lookalike_business_id": "<string>",
"lookalike_business_name": "<string>",
"lookalike_website": "<string>",
"lookalike_description": "<string>",
"lookalike_number_of_employees_range": "1-10",
"lookalike_revenue_range": "0-500K",
"lookalike_naics_description": "<string>",
"lookalike_country_location": "<string>",
"similarity_score": "<string>"
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Sync
Lookalikes
POST
/
v2
/
businesses
/
lookalikes
/
enrich
V2 Businesses Lookalikes Enrich
curl --request POST \
--url https://api.explorium.ai/v2/businesses/lookalikes/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793"
]
}
'import requests
url = "https://api.explorium.ai/v2/businesses/lookalikes/enrich"
payload = { "business_ids": ["8adce3ca1cef0c986b22310e369a0793"] }
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({business_ids: ['8adce3ca1cef0c986b22310e369a0793']})
};
fetch('https://api.explorium.ai/v2/businesses/lookalikes/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.explorium.ai/v2/businesses/lookalikes/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([
'business_ids' => [
'8adce3ca1cef0c986b22310e369a0793'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api_key: <api-key>"
],
]);
$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.explorium.ai/v2/businesses/lookalikes/enrich"
payload := strings.NewReader("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api_key", "<api-key>")
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.explorium.ai/v2/businesses/lookalikes/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/businesses/lookalikes/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"business_id": "<string>",
"data": {
"business_id": "<string>",
"lookalike_business_id": "<string>",
"lookalike_business_name": "<string>",
"lookalike_website": "<string>",
"lookalike_description": "<string>",
"lookalike_number_of_employees_range": "1-10",
"lookalike_revenue_range": "0-500K",
"lookalike_naics_description": "<string>",
"lookalike_country_location": "<string>",
"similarity_score": "<string>"
}
}
],
"total_results": 123
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Description
This enrichment is powered by Ocean.io, a provider of lookalike companies based on advanced similarity analysis.
v2: this endpoint accepts either a single ID (a string) or a list of up to 50 IDs — the separate
/bulk_enrich route is gone. See v2 conventions.Enrich by company details instead of IDs
business_ids is the primary way to call this endpoint. If you don’t have Explorium IDs yet, you can send businesses_to_match instead: up to 50 companies, described with the same fields the Match businesses endpoint accepts (name, domain, url, linkedin_url). Each company is matched and enriched in the same call. Send either business_ids or businesses_to_match, never both (that returns a 422). Any parameters the endpoint takes work the same either way.
{
"businesses_to_match": [
{ "name": "Explorium", "domain": "explorium.ai" },
{ "name": "Unknown Co", "domain": "unknown-co.example" }
]
}
{
"response_context": {
"correlation_id": "ebe38f2b99ad423e84f93d2be5e75b20",
"request_status": "success",
"time_taken_in_seconds": 5.38
},
"data": [
{
"input": { "name": "Explorium", "domain": "explorium.ai", "url": null, "linkedin_url": null },
"business_id": "340c8040bd50cbab9c7df718bbe51cc9",
"data": { "business_id": "340c8040bd50cbab9c7df718bbe51cc9", "...": "same fields as an ID-based request" },
"warnings": []
},
{
"input": { "name": "Unknown Co", "domain": "unknown-co.example", "url": null, "linkedin_url": null },
"business_id": null,
"data": null,
"warnings": []
}
],
"total_results": 1,
"total_matches": 1
}
input and returns the matched business_id. Companies that don’t match come back with business_id: null and data: null, and aren’t charged. total_matches counts the matched rows.
How It Works
How It Works
- Input: Provide a
business_idobtained from the Match Businesses API. - Processing: The system identifies businesses with high similarity scores based on business attributes, descriptions, and digital footprint.
- Output: A list of lookalike companies with attributes such as name, website, industry, size, revenue range, and similarity score.
Example Request (cURL)
Example Request (cURL)
Bash
{
"request_context": {
"seller_id": "sample_id"
},
"business_id": "9664930a34aa8e59f9b994b70e8bc15e"
}
Example Response
Example Response
JSON
{
"response_context": {
"correlation_id": "fe2bade7db0640d0887aebc6d0e2e3f3",
"request_status": "success",
"time_taken_in_seconds": 3.071
},
"data": [
{
"business_id": "9664930a34aa8e59f9b994b70e8bc15e",
"lookalike_business_id": "443fbc49b4ab9988d64065d7e2fddf1a",
"lookalike_business_name": "centrify",
"lookalike_website": "https://delinea.com",
"lookalike_description": "Please follow Delinea on Linkedin! Centrify is now Delinea....",
"lookalike_number_of_employees_range": "501-1000",
"lookalike_revenue_range": "75M-200M",
"lookalike_naics_description": "Software Publishers",
"lookalike_country_location": "us",
"similarity_score": "High"
},
{
"business_id": "9664930a34aa8e59f9b994b70e8bc15e",
"lookalike_business_id": "b5bff70c7cd89e7677a6863751678f30",
"lookalike_business_name": "innskill",
"lookalike_website": "https://innskill.com",
"lookalike_description": "INNSKILL - Empowering Businesses with IAM and Cybersecurity Solutions At INNSKILL, we specialize in providing comprehensive Identity and Access Management (IAM) .....",
"lookalike_number_of_employees_range": "51-200",
"lookalike_revenue_range": "10M-25M",
"lookalike_naics_description": "Computer Systems Design and Related Services",
"lookalike_country_location": "nl",
"similarity_score": "High"
},
{
"business_id": "9664930a34aa8e59f9b994b70e8bc15e",
"lookalike_business_id": "0c9e2098799d2d7ac37eba0c7aac5060",
"lookalike_business_name": "saviynt",
"lookalike_website": "https://saviynt.com",
"lookalike_description": "About Us At Saviynt, we are pioneers in intelligent identity security solutions....",
"lookalike_number_of_employees_range": "1001-5000",
"lookalike_revenue_range": "500M-1B",
"lookalike_naics_description": "Software Publishers",
"lookalike_country_location": "us",
"similarity_score": "High"
}
]
}
Best Practices
Best Practices
Always use a validbusiness_idobtained via the Match Businesses API.- Interpret similarity scores to prioritize the strongest matches for your use case (e.g. focus on “High” similarity for precise lookalikes).
- Combine lookalike insights with other enrichment signals (e.g. firmographics, technographics) for deeper segmentation.
- Re-run lookalike queries periodically to capture changes in the business landscape and discover new similar companies.
Lookalike Companies Output Signals
Lookalike Companies Output Signals
| SignalAPI | Name | Description | Data Type |
|---|---|---|---|
| comparable_business_id | Comparable Business ID | The Explorium ID of the requested company. | string |
| lookalike_business_id | Lookalike Business ID | The Explorium ID of the lookalike company. | string |
| lookalike_business_name | Lookalike Business Name | Name of the lookalike company. | string |
| lookalike_website | Lookalike Website | Website URL of the lookalike. | string |
| lookalike_description | Lookalike Description | Description of the lookalike company. | string |
| lookalike_number_of_employees_range | Lookalike Number of Employees Range | Employee range for the lookalike. | string |
| lookalike_revenue_range | Lookalike Revenue Range | Revenue range for the lookalike. | string |
| lookalike_naics_description | Lookalike NAICS Description | NAICS (North American Industry Classification System) description for the lookalike. | string |
| lookalike_country_location | Lookalike Country Location | The country of operation for the lookalike. | string |
| similarity_score | Similarity Score | Similarity score of the lookalike to the requested company. Medium (0.95–0.975), High (0.975+) | string |
Body
application/json
- V2BusinessEnrichRequest
- V2BusinessEnrichRequest
Provide exactly one of business_ids or businesses_to_match; at most 50 entities.
Response
Successful Response
- V2BusinessEnrichResponse[LookalikesOutputSchema]
- V2BusinessMatchEnrichResponse[LookalikesOutputSchema]
This is base response model for all responses in partner service.
Was this page helpful?