PRpredictleads
Similar Companies Dataset

Get Similar Companies

Changed on

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

get/companies/{company_id_or_domain}/similar_companies

Request

  • Base URL
    https://predictleads.com/api/v3
  • Auth
    • API key in header X-API-KEY and API key in header X-API-TOKEN
    • or HTTP basic
    • or OAuth 2
      Client credentials
      Token URL: https://oauth.predictleads.com/token

Path parameters

company_id_or_domainstring required

Company's ID or domain.

Query parameters

pageinteger

Page number of shown items. <br> NOTE: If the parameter is not provided, the meta property count will be omitted from response for performance reasons.

limitinteger

Limit the number of shown items per page.

Response

Request was successfully processed.

dataSimilarCompany[] required(unresolved $ref)
includedCompanyLite[] required(unresolved $ref)

Contains objects referenced in property relationships.

Example response

{
  "data": [
    {
      "id": "01a0aa0e-1b04-7d3c-ad74-6ac217db710b",
      "type": "company_similarity",
      "attributes": {
        "score": 0.9839,
        "position": 1,
        "reason": "Both are major contractors for the U.S. government providing advanced aerospace, defense, and space exploration systems.",
        "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,
        "position": 2,
        "reason": "Both are global leaders in aerospace manufacturing, developing complex launch vehicles and satellite infrastructure.",
        "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,
        "position": 3,
        "reason": "Both are primary competitors in the aerospace industry, focusing on space transportation, satellite systems, and launch services.",
        "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,
        "position": 4,
        "reason": "Both are private spaceflight companies developing reusable launch vehicles and infrastructure for orbital and suborbital missions.",
        "refreshed_at": "2026-09-16T11:50:46Z"
      },
      "relationships": {
        "company": {
          "data": {
            "id": "6d68ddad-b478-51d4-9d77-7025143e6651",
            "type": "company"
          }
        },
        "similar_company": {
          "data": {
            "id": "2905c749-abd8-52e6-ba5c-4cacf7fbaeb0",
            "type": "company"
          }
        }
      }
    },
    {
      "id": "01a0aa0e-1b04-7270-a9a7-9b69ed22e17f",
      "type": "company_similarity",
      "attributes": {
        "score": 0.976,
        "position": 5,
        "reason": "Both provide critical space systems, launch capabilities, and advanced technology solutions for government and commercial space programs.",
        "refreshed_at": "2026-09-16T11:50:46Z"
      },
      "relationships": {
        "company": {
          "data": {
            "id": "6d68ddad-b478-51d4-9d77-7025143e6651",
            "type": "company"
          }
        },
        "similar_company": {
          "data": {
            "id": "122f9f08-0c78-5749-946a-763c0ba1e0eb",
            "type": "company"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "6d68ddad-b478-51d4-9d77-7025143e6651",
      "type": "company",
      "attributes": {
        "domain": "spacex.com",
        "company_name": "Spacex",
        "ticker": "NASDAQ:SPCX"
      }
    },
    {
      "id": "122f9f08-0c78-5749-946a-763c0ba1e0eb",
      "type": "company",
      "attributes": {
        "domain": "northropgrumman.com",
        "company_name": "Northrop Grumman",
        "ticker": "NYSE:NOC"
      }
    },
    {
      "id": "2905c749-abd8-52e6-ba5c-4cacf7fbaeb0",
      "type": "company",
      "attributes": {
        "domain": "blueorigin.com",
        "company_name": "Blue Origin",
        "ticker": null
      }
    },
    {
      "id": "6fb98527-4afb-5d31-8161-01f0ac9edb9d",
      "type": "company",
      "attributes": {
        "domain": "boeing.com",
        "company_name": "Boeing Co.",
        "ticker": "NYSE:BA-PA"
      }
    },
    {
      "id": "9600c07d-9716-5cae-aef3-37903278ff00",
      "type": "company",
      "attributes": {
        "domain": "airbus.com",
        "company_name": "Airbus SE",
        "ticker": "NASDAQOTH:EADSY"
      }
    },
    {
      "id": "5ac57f35-e133-5e05-8ddd-5c28474bde9c",
      "type": "company",
      "attributes": {
        "domain": "lockheedmartin.com",
        "company_name": "Lockheed Martin Corporation",
        "ticker": "NYSE:LMT"
      }
    }
  ],
  "meta": {
    "schema_version": "3.0",
    "record_state": "active"
  }
}

Changes

  • 113413aee4a2Revision changes
    • info

      api operation id company_similar_companies removed and replaced with get_api_v3_companies_similar_companies

  • a56831a1efd4Revision changes
    • breaking

      for the query request parameter limit, default value was changed from 5 to 20

    • info

      added the new optional query request parameter page

    • info

      added the non-success response with the status