--- updatedAt: 2026-05-19T20:32:06.000Z agentTools: projectIndex: https://docs.gtm.ai/llms.txt --- # Find Similar Companies Company Lookalikes can be used to retrieve a ranked list of companies that are similar to a given reference company. The similar companies are identified using a machine learning model that analyzes industry, revenue range, employee count, and other firmographic signals. These lookalike companies can be used to power prospecting, territory planning, or market expansion workflows where one wants to quickly find companies that "look like" a successful or high-priority account. **IMPORTANT: Either `filter[companyId]` or `filter[companyName]` MUST be provided. Omitting both will result in a 422 error.** To find Company Lookalikes, select the `companyId`, which identifies the company you want to use as the basis for finding lookalikes. If you are not able to provide the `companyId`, you can provide only the `companyName` instead, the service will attempt to resolve the best matching company and then return lookalike companies based on that company. The more precise the company name is (for example, use the full company name with correct spelling and full legal name), the more likely the service is able to track down the company ID and use it to find lookalikes. Optionally, you can narrow the results using the following boolean filters. When set to true, each filter restricts lookalikes to companies that share the corresponding attribute with the reference company: - `filter[sameRevenueRange]`: same revenue range - `filter[sameCountry]`: same country - `filter[sameIndustry]`: same industry - `filter[sameEmployeeRange]`: same employee count range Behind the scenes, the model uses a semantic vector representation of the reference company's data to efficiently find similar companies in the ZoomInfo database. The endpoint returns up to 100 lookalike companies, ordered from the most similar company to the least similar company (descending order by similarity score `attributes.score`). To control the number of results returned, use the `page[size]` parameter with any integer value between 1 and 100. Each result includes the company name, similarity score, rank, and key firmographic attributes such as industry, revenue range, employee range, and country. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Copilot API V1", "version": "1.0", "contact": { "name": "ZoomInfo Customer Support", "email": "help@zoominfo.com" }, "description": "Copilot API for interacting with the Copilot related services." }, "tags": [ { "name": "Recommendations" } ], "paths": { "/copilot/v1/companies/lookalikes": { "get": { "operationId": "CompanyLookalikesInterface_companyLookalikes", "summary": "Find Similar Companies", "description": "Company Lookalikes can be used to retrieve a ranked list of companies that are similar to a given reference company.\nThe similar companies are identified using a machine learning model that analyzes industry, revenue range, employee count, and other firmographic signals.\nThese lookalike companies can be used to power prospecting, territory planning, or market expansion workflows where one wants to quickly find companies that \"look like\" a\nsuccessful or high-priority account.\n\n**IMPORTANT: Either `filter[companyId]` or `filter[companyName]` MUST be provided. Omitting both will result in a 422 error.**\n\nTo find Company Lookalikes, select the `companyId`, which identifies the company you want to use as the basis for finding lookalikes.\nIf you are not able to provide the `companyId`, you can provide only the `companyName` instead, the service\nwill attempt to resolve the best matching company and then return lookalike companies based on that company. The more precise the\ncompany name is (for example, use the full company name with correct spelling and full legal name), the more likely the\nservice is able to track down the company ID and use it to find lookalikes.\n\nOptionally, you can narrow the results using the following boolean filters. When set to true, each filter restricts\nlookalikes to companies that share the corresponding attribute with the reference company:\n- `filter[sameRevenueRange]`: same revenue range\n- `filter[sameCountry]`: same country\n- `filter[sameIndustry]`: same industry\n- `filter[sameEmployeeRange]`: same employee count range\n\nBehind the scenes, the model uses a semantic vector representation of the reference company's data to efficiently find similar companies in the ZoomInfo database.\n\nThe endpoint returns up to 100 lookalike companies, ordered from the most similar company to the least similar company (descending order by similarity score `attributes.score`).\nTo control the number of results returned, use the `page[size]` parameter with any integer value between 1 and 100.\nEach result includes the company name, similarity score, rank, and key firmographic attributes such as industry, revenue range, employee range, and country.", "parameters": [ { "name": "filter[companyId]", "in": "query", "required": false, "description": "Unique ZoomInfo identifier for the reference company used to retrieve lookalikes. Required if companyName is not provided.", "schema": { "type": "string" }, "explode": false }, { "name": "filter[companyName]", "in": "query", "required": false, "description": "Name of the reference company used to retrieve lookalikes. Required if companyId is not provided.", "schema": { "type": "string" }, "explode": false }, { "name": "filter[sameRevenueRange]", "in": "query", "required": false, "description": "When true, restricts results to companies within the same revenue range as the reference company.", "schema": { "type": "boolean" }, "explode": false }, { "name": "filter[sameCountry]", "in": "query", "required": false, "description": "When true, restricts results to companies in the same country as the reference company.", "schema": { "type": "boolean" }, "explode": false }, { "name": "filter[sameIndustry]", "in": "query", "required": false, "description": "When true, restricts results to companies in the same industry as the reference company.", "schema": { "type": "boolean" }, "explode": false }, { "name": "filter[sameEmployeeRange]", "in": "query", "required": false, "description": "When true, restricts results to companies within the same employee count range as the reference company.", "schema": { "type": "boolean" }, "explode": false }, { "name": "page[size]", "in": "query", "required": false, "description": "Number of records to return per page. Default is 25, maximum is 100.", "schema": { "type": "integer", "format": "int32", "minimum": 1, "maximum": 100, "default": 25 }, "explode": false } ], "responses": { "200": { "description": "Success", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/CompanyLookalikesResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "401": { "description": "Unauthorized", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "403": { "description": "Forbidden", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "429": { "description": "Too Many Requests", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } } }, "tags": [ "Recommendations" ], "security": [ { "OAuth2Auth": [ "api:recommendations:read" ] } ], "x-api-roles": [ "fea:zia", "fea:api" ], "x-api-role-requirement": "ANY_REQUIRED" } } }, "security": [ { "OAuth2Auth": [] } ], "components": { "schemas": { "ZoomInfo.Core.Foundations.ErrorSourceModel": { "type": "object", "properties": { "cookie": { "type": "string", "description": "Identifies the cookie name that caused the issue" }, "header": { "type": "string", "description": "Identifies the header name that caused the error" }, "pointer": { "type": "string", "description": "An RFC 6901 compliant JSON pointer to the entity in the request body that caused the error" }, "parameter": { "type": "string", "description": "The name of the path or query parameter that caused the error" } } }, "ZoomInfo.Core.Foundations.ErrorModel": { "type": "object", "required": [ "id", "code", "status" ], "properties": { "id": { "type": "string", "description": "The unique id used to identify this specific error instance" }, "code": { "type": "string", "description": "The error code describing the error category. A full list of error codes can be found in the documentation for each service" }, "detail": { "type": "string", "description": "Message containing the specific details about this occurrence of the error" }, "source": { "allOf": [ { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorSourceModel" } ], "description": "An optional object identifying which part of the request caused the error" }, "status": { "type": "string", "description": "The HTTP status code for the error" }, "title": { "type": "string", "description": "The error name that describes this type of error" } }, "description": "The object describing a specific error from the API" }, "ZoomInfo.Core.Foundations.ErrorResponseModel": { "type": "object", "required": [ "errors" ], "properties": { "detail": { "type": "string", "description": "A high-level detail of the error(s) that occurred during the request" }, "title": { "type": "string", "description": "A high-level summary of the error(s) detected" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorModel" }, "description": "The list of errors raised during the request" } }, "description": "The standard error response body model for the ZoomInfo API." }, "SimilarCompanyAttributes": { "type": "object", "required": [ "companyName", "score", "rank", "industry", "revenueRange", "employeeRange", "country" ], "properties": { "companyName": { "type": "string", "description": "Name of the lookalike company." }, "score": { "type": "number", "format": "double", "description": "Similarity score between the input company and the lookalike company, ranging from 0 to 1. Higher values indicate higher similarity." }, "rank": { "type": "integer", "format": "int32", "description": "Rank of the lookalike company in the results, with 1 being the most similar." }, "industry": { "type": "string", "description": "Primary industry of the lookalike company." }, "revenueRange": { "type": "string", "description": "Revenue range of the lookalike company." }, "employeeRange": { "type": "string", "description": "Employee count range of the lookalike company." }, "country": { "type": "string", "description": "Country where the lookalike company is headquartered." } }, "description": "Attributes describing a single similar company." }, "CompanyLookalike": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "The unique identifier for the resource" }, "type": { "type": "string", "description": "The type of the resource", "default": "CompanyLookalike", "pattern": "CompanyLookalike" }, "attributes": { "allOf": [ { "$ref": "#/components/schemas/SimilarCompanyAttributes" } ], "description": "The attributes defining the resource" } }, "description": "Resource model for a company lookalike result." }, "CompanyLookalikesResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CompanyLookalike" }, "description": "The primary data of the document" } }, "description": "Response model for company lookalikes" } }, "securitySchemes": { "OAuth2Auth": { "type": "oauth2", "flows": { "authorizationCode": { "authorizationUrl": "https://login.zoominfo.com", "tokenUrl": "https://okta-login.zoominfo.com/oauth2/default/v1/token", "scopes": { "api:account-summary:read": "Read Copilot Account Summary Data", "api:insights:read": "Read Insights Data", "api:recommendations:read": "Read Copilot recommendation data", "api:gtm-config:read": "Read GTM configuration data", "api:gtm-config:manage": "Manage GTM configuration data (create, update, delete)" } } } } } }, "servers": [ { "url": "https://api.zoominfo.com/gtm", "description": "Base URL for the Copilot API" } ] } ``` # Sibling pages * [Get Contact Recommendations](https://docs.gtm.ai/zoominfoenterprise/reference/contactrecommendationsinterface_getcontactrecommendations.md) * [Get Contact Lookalikes](https://docs.gtm.ai/zoominfoenterprise/reference/contactlookalikesinterface_getcontactlookalikes.md)