Lookalikes (async)

Businesses Lookalikes Job

curl --request POST \
  --url https://api.explorium.ai/v2/businesses/lookalikes/job \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "list_id": "<string>"
}
'

import requests

url = "https://api.explorium.ai/v2/businesses/lookalikes/job"

payload = { "list_id": "<string>" }
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({list_id: '<string>'})
};

fetch('https://api.explorium.ai/v2/businesses/lookalikes/job', 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/job",
  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([
    'list_id' => '<string>'
  ]),
  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/job"

	payload := strings.NewReader("{\n  \"list_id\": \"<string>\"\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/job")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"list_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v2/businesses/lookalikes/job")

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  \"list_id\": \"<string>\"\n}"

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

{
  "job_id": "<string>",
  "status": "<string>",
  "status_url": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

POST

businesses

lookalikes

job

Businesses Lookalikes Job

curl --request POST \
  --url https://api.explorium.ai/v2/businesses/lookalikes/job \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "list_id": "<string>"
}
'

import requests

url = "https://api.explorium.ai/v2/businesses/lookalikes/job"

payload = { "list_id": "<string>" }
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({list_id: '<string>'})
};

fetch('https://api.explorium.ai/v2/businesses/lookalikes/job', 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/job",
  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([
    'list_id' => '<string>'
  ]),
  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/job"

	payload := strings.NewReader("{\n  \"list_id\": \"<string>\"\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/job")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"list_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v2/businesses/lookalikes/job")

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  \"list_id\": \"<string>\"\n}"

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

{
  "job_id": "<string>",
  "status": "<string>",
  "status_url": "<string>"
}

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

The Lookalike Companies Enrichment identifies and returns businesses that closely resemble a given company across key dimensions such as industry, size, geography, and online presence. This enrichment is powered by an external API provided by Ocean.io, which uses its own similarity engine to surface relevant company lookalikes. Similarity scores are calculated based on a combination of structured business attributes (e.g., number of employees, revenue range, industry classification, and country), semantic similarity of company descriptions, digital footprint overlap (such as website content and web signals), and additional contextual indicators sourced from Ocean.io’s data graph. For each input company (business_id), the enrichment returns up to 3 lookalike companies, including their firmographic attributes and a similarity score indicating the strength of the match (e.g., Medium or High). This enrichment provides a powerful signal for identifying companies that “look like” your target ideal for use cases such as lead generation, market expansion, competitive intelligence, and segmentation strategies.

Asynchronous variant. This submits a job through the async job infrastructure — poll job status for progress and results. Input comes from an uploaded dataset (list_id); limits are 10,000 rows and a 24-hour run time.For the full output signal reference, see the synchronous endpoint.

How It Works

Input: Provide a business_id obtained 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)

Bash

{
"request_context": {
"seller_id": "sample_id"
},
"business_ids": ["9664930a34aa8e59f9b994b70e8bc15e"]
}

Example Response

JSON

{
  "response_context": {
    "correlation_id": "be542cecda9b40c8af830adc25b71b0c",
    "request_status": "success",
    "time_took_in_seconds": 2.317
  },
  "data": [
    {
      "business_id": "9664930a34aa8e59f9b994b70e8bc15e",
      "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, a leading provider of privileged access management (PAM) solutions that make security seamless for the modern, hybrid enterprise. Our solutions empower organizations to secure critical data, devices, code, and cloud infrastructure to help reduce risk, ensure compliance, and simplify security. Delinea removes complexity and defines the boundaries of access for thousands of customers worldwide. Our customers range from small businesses to the world's largest financial institutions, intelligence agencies, and critical infrastructure companies.",
        "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",
      "data": {
        "business_id": "9664930a34aa8e59f9b994b70e8bc15e",
        "lookalike_business_id": "0230a888e8196d7b94ddd866d2e4d9fc",
        "lookalike_business_name": "beyondtrust",
        "lookalike_website": "https://beyondtrust.com",
        "lookalike_description": "BeyondTrust is a global leader in Privileged Access Management (PAM), offering advanced solutions to secure and manage privileges across traditional, cloud, and hybrid environments. Their Universal Privilege Management approach protects privileges related to passwords, endpoints, and access, enhancing visibility and control for organizations to reduce risk, ensure compliance, and improve operational performance. Trusted by 20,000 customers, including 78 of the Fortune 100, BeyondTrust's platform empowers organizations to shrink their attack surface and mitigate security blind spots through intelligent identity threat detection and privilege control.",
        "lookalike_number_of_employees_range": "1001-5000",
        "lookalike_revenue_range": "500M-1B",
        "lookalike_naics_description": "Computer Systems Design Services",
        "lookalike_country_location": "us",
        "similarity_score": "High"
      }
    },
    {
      "business_id": "9664930a34aa8e59f9b994b70e8bc15e",
      "data": {
        "business_id": "9664930a34aa8e59f9b994b70e8bc15e",
        "lookalike_business_id": "21d52ef9535ea4e6d0872a8c15dc2b59",
        "lookalike_business_name": "cyberi3secure",
        "lookalike_website": "https://cyberi3secure.com",
        "lookalike_description": "Cyberi3Secure is uniquely qualified to help companies improve efficiency, strengthen compliance, and protecting data and assets by addressing privilege access management. Our specialized focus on PAM practice, combined with our deep knowledge and experience, we can deliver and deploy customized privilege access management solutions for every customer.",
        "lookalike_number_of_employees_range": "11-50",
        "lookalike_revenue_range": "5M-10M",
        "lookalike_naics_description": "Computer Systems Design and Related Services",
        "lookalike_country_location": "in",
        "similarity_score": "High"
      }
    }
  ],
  "total_results": 3
}

Best Practices

Always use a validbusiness_id obtained 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

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

For additional enrichment options, explore related API endpoints below.

Authorizations

api_key

string

header

required

Body

application/json

list_id

string

required

Entity ID list identifier returned by the upload endpoint

Response

Successful Response

job_id

string

required

status

string

required

status_url

string

required

⌘I

Getting started

Businesses

Business enrichments

Prospects

Prospect enrichments

Research (GenAI)

Async jobs

Autocomplete

Credits

Events & Webhooks

Description

Authorizations

Body

Response

​Description

Authorizations

Body

Response

Description