{"uid":"cap_C_Q-NV5q9I03C00lRMeXe","slug":"agents-predictleads-com-get-similar-companies-04cda48f","name":"Get Similar Companies","description":"Returns a list of a company's Similar Companies and, for the top 20, provides a reason why they are considered similar.","url":"https://agents.predictleads.com/api/v3/companies/{company_id_or_domain}/similar_companies?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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-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,"reason":"Both provide critical space systems, launch capabilities, and advanced technology solutions for government and commercial space programs.","position":5,"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"}}}}],"meta":{"record_state":"active","schema_version":"3.0"},"included":[{"id":"6d68ddad-b478-51d4-9d77-7025143e6651","type":"company","attributes":{"domain":"spacex.com","ticker":"NASDAQ:SPCX","company_name":"Spacex"}},{"id":"122f9f08-0c78-5749-946a-763c0ba1e0eb","type":"company","attributes":{"domain":"northropgrumman.com","ticker":"NYSE:NOC","company_name":"Northrop Grumman"}},{"id":"2905c749-abd8-52e6-ba5c-4cacf7fbaeb0","type":"company","attributes":{"domain":"blueorigin.com","ticker":null,"company_name":"Blue Origin"}},{"id":"6fb98527-4afb-5d31-8161-01f0ac9edb9d","type":"company","attributes":{"domain":"boeing.com","ticker":"NYSE:BA-PA","company_name":"Boeing Co."}},{"id":"9600c07d-9716-5cae-aef3-37903278ff00","type":"company","attributes":{"domain":"airbus.com","ticker":"NASDAQOTH:EADSY","company_name":"Airbus SE"}},{"id":"5ac57f35-e133-5e05-8ddd-5c28474bde9c","type":"company","attributes":{"domain":"lockheedmartin.com","ticker":"NYSE:LMT","company_name":"Lockheed Martin Corporation"}}]},"summary":"Information about company's similar companies.\n","required":["data","included"],"properties":{"data":{"type":"array","items":{"type":"object","title":"SimilarCompany","required":["id","type","attributes","relationships"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the `SimilarCompany` object."},"type":{"const":"company_similarity","description":"Type of the `SimilarCompany` object."},"attributes":{"type":"object","required":["score","position","reason","refreshed_at"],"properties":{"score":{"type":"number","example":0.85,"maximum":1,"minimum":0,"description":"Similarity score between the companies."},"reason":{"type":["string","null"],"example":null,"description":"Reason why this company is considered a similar company."},"position":{"type":["integer","null"],"example":1,"maximum":50,"minimum":1,"description":"Position of the similar company in the list."},"refreshed_at":{"type":"string","format":"date-time","example":"2024-09-25T16:09:53Z","description":"Date & time (ISO 8601) when the similar company data was last refreshed."}},"description":"Attributes of the `SimilarCompany` object."},"relationships":{"type":"object","required":["company","similar_company"],"properties":{"company":{"type":"object","title":"SimilarCompanyToCompanyLiteRelationship","required":["data"],"properties":{"data":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the included `CompanyLite` object."},"type":{"const":"company","description":"Type of the included `CompanyLite` object."}}}},"description":"The data contains a reference to related `CompanyLite` object listed in the `included` property."},"similar_company":{"type":"object","title":"SimilarCompanyToCompanyLiteRelationship","required":["data"],"properties":{"data":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the included `CompanyLite` object."},"type":{"const":"company","description":"Type of the included `CompanyLite` object."}}}},"description":"The data contains a reference to related `CompanyLite` object listed in the `included` property."}},"description":"The data contains references to related objects listed in the `included` property."}},"description":"The `SimilarCompany` object."}},"meta":{"type":"object","required":["schema_version","record_state"],"properties":{"count":{"type":"integer","example":344,"description":"Total number of results.\n<br>\n**NOTE**: Only included in API responses when the request parameter `page` is provided,\nfor performance reasons.\n"},"record_state":{"type":"string","const":"active","title":"Meta.RecordState","description":"Represents record state of objects.\n"},"schema_version":{"type":"string","title":"Meta.SchemaVersion","description":"Represents schema version of objects.\n"}},"description":"Meta information about `SimilarCompaniesDataset` object.\n"},"included":{"type":"array","items":{"type":"object","title":"CompanyLite","required":["id","type","attributes"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the `CompanyLite` object."},"type":{"const":"company","description":"Type of the `CompanyLite` object."},"attributes":{"type":"object","required":["domain","company_name","ticker"],"properties":{"domain":{"type":"string","description":"Company domain name."},"ticker":{"type":["string","null"],"description":"Company stock symbol (ticker) if available."},"company_name":{"type":["string","null"],"description":"Company name if available."}},"description":"Attributes of the `CompanyLite` object."}},"description":"The `CompanyLite` object."},"description":"Contains objects referenced in property `relationships`."}},"description":"PredictLeads provides Similar Companies data for over 18.5 million companies, identifying businesses that are similar to a given company.\nThe intelligent matching is powered by all PredictLeads datasets, including technologies, news events, job openings, and more, including a reason attribute explaining why two companies are similar.\n"},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"12.0000","medianCents":"12.0000","p90Cents":"12.0000","minCents":"12.0000","maxCents":"12.0000","p95Cents":"12.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"~$0.12/call (observed)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_Hm1HzmR178UYCz_PaOrUg","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.predictleads.com","brandSlug":"agents-predictleads-com-x402","brandBaseUrl":"https://agents.predictleads.com","brandDocsUrl":null,"whatItDoes":"Returns a ranked list of companies similar to a given company, with similarity scores and natural-language reasons for the top 20.","exampleAgentPrompt":"Can you pull up the top similar companies to spacex.com and show me why each one is considered similar?","exampleUseCases":[{"title":"Competitive landscape mapping for a startup","prompt":"I'm researching the competitive landscape around Stripe — can you fetch the top 20 similar companies to stripe.com and give me the reason each one is considered a peer?"},{"title":"Finding acquisition targets in a sector","prompt":"We're looking for companies similar to palantir.com to evaluate as potential acquisition targets — please get me their closest peers with similarity scores."},{"title":"Discovering alternatives to a vendor","prompt":"My team uses Snowflake and we want to know what comparable data warehouse companies exist — can you look up the companies most similar to snowflake.com and explain why they're similar?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-10-27T05:09:08.081Z","lastSuccessfullyRanAt":"2026-10-27T05:09:08.081Z","lastHealthCheckAt":"2026-10-30T19:14:12.337Z","isFirstParty":false,"canonicalSlug":"agents-predictleads-com-get-similar-companies-04cda48f"}