# Get Similar Companies

> Get Similar Companies is a paid API for AI agents from agents.predictleads.com, paid per call via MPP, ~$0.12/call (observed), status healthy (last checked 2026-10-30, last successful call 2026-10-27).

Returns a ranked list of companies similar to a given company, with similarity scores and natural-language reasons for the top 20.

## Facts

- Endpoint: GET https://agents.predictleads.com/api/v3/companies/{company_id_or_domain}/similar_companies?utm_source=zero.xyz
- Price: ~$0.12/call (observed)
- Payment: MPP
- Status: healthy
- Last checked: 2026-10-30
- Last successful call: 2026-10-27
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Provider: agents.predictleads.com
- Website: https://agents.predictleads.com
- Canonical page: https://www.zero.xyz/c/agents-predictleads-com-get-similar-companies-04cda48f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C_Q-NV5q9I03C00lRMeXe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-predictleads-com-get-similar-companies-04cda48f
```

Example prompt: Can you pull up the top similar companies to spacex.com and show me why each one is considered similar?

## When to prefer this

Use this endpoint when you need a ranked, explainable list of companies that are similar to a known company — especially when you want to understand the competitive landscape, find peer companies, or discover alternatives. Prefer this over generic web search when you need structured similarity data with scores and AI-generated reasons, sourced from a database of 120M+ companies.

## Known failure modes

- Invalid or unknown company_id_or_domain returns a 404 or empty data array
- Requesting a page beyond available results returns an empty data array
- Missing required path parameter company_id_or_domain returns a 400 error
- Rate limiting or authentication failure returns a 401 or 429 error
- Similarity reasons are only provided for the top 20 results; beyond that, reason field may be absent

## How this service works

Returns a list of a company's Similar Companies and, for the top 20, provides a reason why they are considered similar.

## Output

A paginated list of company-similarity objects, each containing a similarity score (0–1), a natural-language reason explaining why the company is similar (for top 20), a rank position, a refresh timestamp, and relationship references to both the source company and the similar company by their IDs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "company_id_or_domain"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "minimum": 1,
   "description": "Page number of shown items.\n<br>\n**NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for\nperformance reasons.\n"
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "description": "Limit the number of shown items per page."
  },
  "company_id_or_domain": {
   "type": "string",
   "description": "Company's ID or domain.\n"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "SimilarCompaniesDataset",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "example": {
  "data": [
   {
    "id": "01a0aa0e-1b04-7d3c-ad74-6ac217db710b",
    "type": "company_similarity",
    "attributes": {
     "score": 0.9839,
     "reason": "Both are major contractors for the U.S. government providing advanced aerospace, defense, and space exploration systems.",
     "position": 1,
     "refreshed_at": "2026-09-16T11:50:46Z"
    },
    "relationships": {
     "company": {
      "data": {
       "id": "6d68ddad-b478-51d4-9d77-7025143e6651",
       "type": "company"
      }
     },
     "similar_company": {
      "data": {
       "id": "5ac57f35-e133-5e05-8ddd-5c28474bde9c",
       "type": "company"
      }
     }
    }
   },
   {
    "id": "01a0aa0e-1b04-703c-ada3-5f4c5bf8432f",
    "type": "company_similarity",
    "attributes": {
     "score": 0.9834,
     "reason": "Both are global leaders in aerospace manufacturing, developing complex launch vehicles and satellite infrastructure.",
     "position": 2,
     "refreshed_at": "2026-09-16T11:50:46Z"
    },
    "relationships": {
     "company": {
      "data": {
       "id": "6d68ddad-b478-51d4-9d77-7025143e6651",
       "type": "company"
      }
     },
     "similar_company": {
      "data": {
       "id": "9600c07d-9716-5cae-aef3-37903278ff00",
       "type": "company"
      }
     }
    }
   },
   {
    "id": "01a0aa0e-1b04-7f42-851c-46e32022d563",
    "type": "company_similarity",
    "attributes": {
     "score": 0.982,
     "reason": "Both are primary competitors in the aerospace industry, focusing on space transportation, satellite systems, and launch services.",
     "position": 3,
     "refreshed_at": "2026-09-16T11:50:46Z"
    },
    "relationships": {
     "company": {
      "data": {
       "id": "6d68ddad-b478-51d4-9d77-7025143e6651",
       "type": "company"
      }
     },
     "similar_company": {
      "data": {
       "id": "6fb98527-4afb-5d31-8161-01f0ac9edb9d",
       "type": "company"
      }
     }
    }
   },
   {
    "id": "01a0aa0e-1b04-77b5-abe5-21e98579f5d4",
    "type": "company_similarity",
    "attributes": {
     "score": 0.9795,
     "reason": "Both are private spaceflight companies developing reusable launch vehicles and infrastructure for orbital and suborbital missions.",
     "position": 4,
     "refreshed_at": "2026-09-16T11:50:46Z"
    },
    "relationships": {
     "company": {
      "data": {
       "id": "6d68ddad-b478
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-predictleads-com-get-similar-companies-04cda48f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.predictleads.com](https://www.zero.xyz/host/agents.predictleads.com/llms.txt)