> ## Documentation Index
> Fetch the complete documentation index at: https://developers.explorium.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Lookalike Companies - by Ocean.IO
## **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.
* **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.
```bash Bash theme={null}
{
"request_context": {
"seller_id": "sample_id"
},
"business_id": "9664930a34aa8e59f9b994b70e8bc15e"
}
```
```json JSON expandable theme={null}
{
"response_context": {
"correlation_id": "fe2bade7db0640d0887aebc6d0e2e3f3",
"request_status": "success",
"time_took_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"
}
],
"entity_id": "9664930a34aa8e59f9b994b70e8bc15e"
}
```
* **`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.
| 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.*
## OpenAPI
````yaml post /v1/businesses/lookalikes/enrich
openapi: 3.1.0
info:
title: Partner Service
version: 0.2.349
servers:
- url: https://api.explorium.ai
description: AgentSource Server
security: []
paths:
/v1/businesses/lookalikes/enrich:
post:
tags:
- BusinessEnrichments
summary: Lookalikes
operationId: businesses_lookalikes_enrich
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BusinessesEnrichRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: >-
#/components/schemas/BusinessesEnrichResponse_LookalikesOutputSchema_
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- APIKeyHeader: []
components:
schemas:
BusinessesEnrichRequest:
properties:
request_context:
type: object
title: Request Context
example: null
nullable: true
parameters:
type: object
title: Parameters
nullable: true
business_id:
type: string
pattern: ^[a-f0-9]{32}$
title: Business Id
additionalProperties: false
type: object
required:
- business_id
title: BusinessesEnrichRequest
BusinessesEnrichResponse_LookalikesOutputSchema_:
properties:
response_context:
$ref: '#/components/schemas/ResponseContext'
data:
anyOf:
- $ref: '#/components/schemas/LookalikesOutputSchema'
- items:
$ref: '#/components/schemas/LookalikesOutputSchema'
type: array
title: Data
entity_id:
anyOf:
- type: string
pattern: ^[a-f0-9]{32}$
- type: string
pattern: ^[a-f0-9]{40}$
title: Entity Id
type: object
required:
- response_context
title: BusinessesEnrichResponse[LookalikesOutputSchema]
description: 'This is base response model for all responses in partner service. '
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ResponseContext:
properties:
correlation_id:
type: string
title: Correlation Id
request_status:
$ref: '#/components/schemas/RequestStatus'
time_took_in_seconds:
type: number
title: Time Took In Seconds
type: object
required:
- correlation_id
- request_status
- time_took_in_seconds
title: ResponseContext
LookalikesOutputSchema:
properties:
business_id:
type: string
pattern: ^[a-f0-9]{32}$
title: Business Id
lookalike_business_id:
type: string
pattern: ^[a-f0-9]{32}$
title: Lookalike Business Id
lookalike_business_name:
type: string
maxLength: 256
title: Lookalike Business Name
lookalike_website:
type: string
maxLength: 2048
pattern: >-
^(https?:)?//(?:(?:[a-z0-9\u00a1-\uffff][a-z0-9\u00a1-\uffff_-]{0,62})?[a-z0-9\u00a1-\uffff]\.)+[a-z\u00a1-\uffff]{2,}\.?(?:[/?#]\S*)?$
format: uri
title: Lookalike Website
lookalike_description:
type: string
title: Lookalike Description
lookalike_number_of_employees_range:
$ref: '#/components/schemas/NumberOfEmployeesRange'
lookalike_revenue_range:
$ref: '#/components/schemas/RevenueRange'
lookalike_naics_description:
type: string
title: Lookalike Naics Description
lookalike_country_location:
type: string
pattern: >-
^(aw|af|ao|ai|ax|al|ad|ae|ar|am|as|aq|tf|ag|au|at|az|bi|be|bj|bq|bf|bd|bg|bh|bs|ba|bl|by|bz|bm|bo|br|bb|bn|bt|bv|bw|cf|ca|cc|ch|cl|cn|ci|cm|cd|cg|ck|co|km|cv|cr|cu|cw|cx|ky|cy|cz|de|dj|dm|dk|do|dz|ec|eg|er|eh|es|ee|et|fi|fj|fk|fr|fo|fm|ga|gb|ge|gg|gh|gi|gn|gp|gm|gw|gq|gr|gd|gl|gt|gf|gu|gy|hk|hm|hn|hr|ht|hu|id|im|in|io|ie|ir|iq|is|il|it|jm|je|jo|jp|kz|ke|kg|kh|ki|kn|kr|kw|la|lb|lr|ly|lc|li|lk|ls|lt|lu|lv|mo|mf|ma|mc|md|mg|mv|mx|mh|mk|ml|mt|mm|me|mn|mp|mz|mr|ms|mq|mu|mw|my|yt|na|nc|ne|nf|ng|ni|nu|nl|no|np|nr|nz|om|pk|pa|pn|pe|ph|pw|pg|pl|pr|kp|pt|py|ps|pf|qa|re|ro|ru|rw|sa|sd|sn|sg|gs|sh|sj|sb|sl|sv|sm|so|pm|rs|ss|st|sr|sk|si|se|sz|sx|sc|sy|tc|td|tg|th|tj|tk|tm|tl|to|tt|tn|tr|tv|tw|tz|ug|ua|um|uy|us|uz|va|vc|ve|vg|vi|vn|vu|wf|ws|xk|ye|za|zm|zw)$
title: Lookalike Country Location
similarity_score:
type: string
title: Similarity Score
type: object
required:
- business_id
title: LookalikesOutputSchema
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
RequestStatus:
type: string
enum:
- success
- miss
- failure
title: RequestStatus
description: >-
The `RequestStatus` class is an enumeration that defines the possible
statuses of a request.
This enum is used to indicate whether a request was successful, missed,
or failed. It ensures
consistent handling of request statuses across the application.
Attributes:
SUCCESS: Indicates that the request was successfully processed.
MISS: Indicates that the request did not find any matching data.
FAILURE: Indicates that the request encountered an error or failure.
NumberOfEmployeesRange:
type: string
enum:
- 1-10
- 11-50
- 51-200
- 201-500
- 501-1000
- 1001-5000
- 5001-10000
- 10001+
title: NumberOfEmployeesRange
description: >-
The `NumberOfEmployeesRange` class is an enumeration that represents
predefined ranges
for the number of employees in a company. These ranges are used for
filtering and
categorizing companies based on their workforce size.
RevenueRange:
type: string
enum:
- 0-500K
- 500K-1M
- 1M-5M
- 5M-10M
- 10M-25M
- 25M-75M
- 75M-200M
- 200M-500M
- 500M-1B
- 1B-10B
- 10B-100B
- 100B-1T
- 1T-10T
- 10T+
title: RevenueRange
description: >-
The `RevenueRange` class is an enumeration that represents predefined
ranges for the revenue of a company.
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: api_key
````