{"uid":"cap_vL2syRwtpVyvMAWcf2S5H","slug":"agents-predictleads-com-predictleads-get-company-connections-e77b9304","name":"PredictLeads Get Company Connections","description":"Returns a list of company's Connections.","url":"https://agents.predictleads.com/api/v3/companies/{company_id_or_domain}/connections?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
\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":100,"maximum":1000,"description":"Limit the number of shown items per page."},"categories":{"type":"array","items":{"type":"string","oneOf":[{"const":"partner","description":"**Read as**: Company1 is a partner of Company2.\n
\nA partner relationship signals a collaboration between companies that goes both in two directions.\nYou will find such connections using titles as \"We work with\", \"Our partners\", \"The company we keep\",\nand other titles similar in meaning. The implications of this category\ncan be quite wide in their meaning, but in general all partnerships are a positive signal.\n
\n**NOTE**: Until February 2024 the `partner` category did not always signal a true partnership\nbetween two companies, but it also included a tighter knit relationship compared to the `other`\ncategory, which are not always as strong as the partner keyword suggests.\nThe meaning is now correctly followed for all new cases or cases that have been last seen since\nand still have the `partner` category.\n"},{"const":"vendor","description":"**Read as**: Company1 is a vendor to Company2.\n
\nThe vendor category is much simpler in its meaning. It simply means that company1 is a supplier\nfor company2 in some way. Some vendor connections signal a more positive relationship, depending\non the source category. For example, a vendor relationship with a testimonial section/page source\ncategory is a stronger positive signal. On a webpage, such connections can be seen in lists such as\n\"Our customers\", \"Trusted by\", \"Enabling businesses to\", etc.\n
\nFor example, to be a vendor to Microsoft, the company has to pass certain requirements as to\ncompany size, product reliability, safety, etc. This can be seen as a vetting process of some sort\nand increases the company's trustworthiness.\n
\nThe vendor category can also be used to determine the supply chain of a certain company and evaluate\nsupply chain risks.\n"},{"const":"integration","description":"**Read as**: Company1 has an integration with Company2.\n
\nMost of the time an integration happens between a platform and a service.\n

\nCase examples:\n\n"},{"const":"investor","description":"**Read as**: Company1 is an investor in Company2.\n
\nThe investor category identifies relationships between companies making investments (Company1)\nand companies receiving investments (Company2).\n
\nThe more investors the company has, the better.\nOne could also track what companies/sectors competitors are investing in.\n"},{"const":"parent","description":"**Read as**: Company1 is a parent company of Company2.\n
\nParent category defines a parent-subsidiary relationship between websites.\nIn some cases such websites are only localized versions for specific markets.\n

\nCase examples:\n\n
\n\n**NOTE**: Often it makes sense to not only check current hierarchy level e.g. \"blizzard.de\"\nbut also check their parent connections e.g. \"blizzard.com\" and \"activisionblizzard.com\".\nSince sometimes company connections (customers, investors…) are also available at higher company\nhierarchical levels.\n"},{"const":"rebranding","description":"**Read as**: Company1 is a rebranding of Company2.\n
\nCompany1 being a rebranding of Company2 suggests that Company2 has undergone a process to change\nits brand identity. We detect rebranding based on domain change and similarities between the old\nand the new website.\n

\nCase examples:\n\n"},{"const":"published_in","description":"**Read as**: Company1 is published in Company2.\n
\nThe `published_in` category is usually found on early stage startup websites with fewer\naccomplishments on the market, but positive press coverage. You can see such connections under\ntitles such as \"As seen in\", \"Featured in\", \"Talking about us\", etc.\n
\nA `published_in` connection is a positive signal, but after some months or years, we would\nexpect to see them removed and replaced with other content proving the legitimacy of the company.\n"},{"const":"badge","description":"**Read as**: Company1 has a badge of Company2.\n
\nThe `badge` category shows that the Company1 has a certificate issued by the Company2 e.g. SOC 2 Type 2,\nISO 27001, or some other common badges like GDPR, CCPA, etc.\n
\nSuch connections may have a TechnologyLite reference present, describing the technology in some detail.\nFull information about that technology is available via the technology endpoint.\n"},{"const":"other","description":"**Read as**: Company1 is connected to Company2.\n
\nThis is the most general category. If we detected a relationship between companies, but we were\nunsure which category it belonged to, or it didn't belong to any of our categories, then we would\ncategorize it as `other`.\n
\nOutgoing `other` category connections are a slightly positive signal, while incoming ones are\nquite more so. Thus a connection Company1 -> other -> Company2 is more positive for Company2, than\nfor Company1. As Company2 was featured on Company1 website.\n
\nSometimes the `other` category can have additional information via the source_category attribute\ndepending on where it was found. An example of such a source_category would be `cookie_section`,\nwhich is explained further below. Such connections could be evaluated differently.\n"}]},"example":["partner","vendor","integration"],"description":"One or more valid categories.\n\n"},"first_seen_at_from":{"type":"string","format":"date","example":"2024-09-25","description":"Only return `Connections` first seen after\ngiven date (ISO 8601).\n"},"first_seen_at_until":{"type":"string","format":"date","example":"2024-09-25","description":"Only return `Connections` first seen before\ngiven date (ISO 8601).\n"},"company_id_or_domain":{"type":"string","description":"Company's ID or domain.\n"}}},"responseSchema":{"type":"object","title":"ConnectionsDataset","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"data":[{"id":"587e4f3f-8149-4918-8a30-89190fa582f8","type":"connection","attributes":{"context":"Yuno partners with Adyen to integrate its global payment solutions, enhancing transaction processing capabilities and unlocking revenue opportunities for businesses. This collaboration ensures seamless integration with various payment providers and fraud solutions, fostering mutual success.","category":"integration","confidence":null,"source_url":"https://y.uno/integrations","last_seen_at":"2026-06-30T11:16:19Z","first_seen_at":"2023-08-02T21:20:41Z","source_category":"integration_page","individual_source_url":"https://www.y.uno/partner/adyen"},"relationships":{"company1":{"data":{"id":"edb175f8-51be-53ef-8af5-bec04dc3a402","type":"company"}},"company2":{"data":{"id":"94d705f4-6650-5055-b643-62d0740cdfa3","type":"company"}},"technology":{"data":null}}}],"meta":{"record_state":"active","schema_version":"3.2"},"included":[{"id":"edb175f8-51be-53ef-8af5-bec04dc3a402","type":"company","attributes":{"domain":"y.uno","ticker":null,"company_name":"Yuno, Inc."}},{"id":"94d705f4-6650-5055-b643-62d0740cdfa3","type":"company","attributes":{"domain":"adyen.com","ticker":"OTC:ADYYF","company_name":"Adyen"}}]},"summary":"Categorized Connections between companies and where available also summarized context of how two\ncompanies work together.\n","required":["data","included"],"properties":{"data":{"type":"array","items":{"type":"object","title":"Connection","required":["id","type","attributes","relationships"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the `Connection` object."},"type":{"const":"connection","description":"Type of the `Connection` object."},"attributes":{"type":"object","required":["category","source_category","source_url","individual_source_url","context","first_seen_at","last_seen_at","confidence"],"properties":{"context":{"type":["null","string"],"description":"Text found near the connection. Often contains additional relationship information between the two companies."},"category":{"type":"string","oneOf":[{"const":"partner","description":"**Read as**: Company1 is a partner of Company2.\n
\nA partner relationship signals a collaboration between companies that goes both in two directions.\nYou will find such connections using titles as \"We work with\", \"Our partners\", \"The company we keep\",\nand other titles similar in meaning. The implications of this category\ncan be quite wide in their meaning, but in general all partnerships are a positive signal.\n
\n**NOTE**: Until February 2024 the `partner` category did not always signal a true partnership\nbetween two companies, but it also included a tighter knit relationship compared to the `other`\ncategory, which are not always as strong as the partner keyword suggests.\nThe meaning is now correctly followed for all new cases or cases that have been last seen since\nand still have the `partner` category.\n"},{"const":"vendor","description":"**Read as**: Company1 is a vendor to Company2.\n
\nThe vendor category is much simpler in its meaning. It simply means that company1 is a supplier\nfor company2 in some way. Some vendor connections signal a more positive relationship, depending\non the source category. For example, a vendor relationship with a testimonial section/page source\ncategory is a stronger positive signal. On a webpage, such connections can be seen in lists such as\n\"Our customers\", \"Trusted by\", \"Enabling businesses to\", etc.\n
\nFor example, to be a vendor to Microsoft, the company has to pass certain requirements as to\ncompany size, product reliability, safety, etc. This can be seen as a vetting process of some sort\nand increases the company's trustworthiness.\n
\nThe vendor category can also be used to determine the supply chain of a certain company and evaluate\nsupply chain risks.\n"},{"const":"integration","description":"**Read as**: Company1 has an integration with Company2.\n
\nMost of the time an integration happens between a platform and a service.\n

\nCase examples:\n\n"},{"const":"investor","description":"**Read as**: Company1 is an investor in Company2.\n
\nThe investor category identifies relationships between companies making investments (Company1)\nand companies receiving investments (Company2).\n
\nThe more investors the company has, the better.\nOne could also track what companies/sectors competitors are investing in.\n"},{"const":"parent","description":"**Read as**: Company1 is a parent company of Company2.\n
\nParent category defines a parent-subsidiary relationship between websites.\nIn some cases such websites are only localized versions for specific markets.\n

\nCase examples:\n\n
\n\n**NOTE**: Often it makes sense to not only check current hierarchy level e.g. \"blizzard.de\"\nbut also check their parent connections e.g. \"blizzard.com\" and \"activisionblizzard.com\".\nSince sometimes company connections (customers, investors…) are also available at higher company\nhierarchical levels.\n"},{"const":"rebranding","description":"**Read as**: Company1 is a rebranding of Company2.\n
\nCompany1 being a rebranding of Company2 suggests that Company2 has undergone a process to change\nits brand identity. We detect rebranding based on domain change and similarities between the old\nand the new website.\n

\nCase examples:\n\n"},{"const":"published_in","description":"**Read as**: Company1 is published in Company2.\n
\nThe `published_in` category is usually found on early stage startup websites with fewer\naccomplishments on the market, but positive press coverage. You can see such connections under\ntitles such as \"As seen in\", \"Featured in\", \"Talking about us\", etc.\n
\nA `published_in` connection is a positive signal, but after some months or years, we would\nexpect to see them removed and replaced with other content proving the legitimacy of the company.\n"},{"const":"badge","description":"**Read as**: Company1 has a badge of Company2.\n
\nThe `badge` category shows that the Company1 has a certificate issued by the Company2 e.g. SOC 2 Type 2,\nISO 27001, or some other common badges like GDPR, CCPA, etc.\n
\nSuch connections may have a TechnologyLite reference present, describing the technology in some detail.\nFull information about that technology is available via the technology endpoint.\n"},{"const":"other","description":"**Read as**: Company1 is connected to Company2.\n
\nThis is the most general category. If we detected a relationship between companies, but we were\nunsure which category it belonged to, or it didn't belong to any of our categories, then we would\ncategorize it as `other`.\n
\nOutgoing `other` category connections are a slightly positive signal, while incoming ones are\nquite more so. Thus a connection Company1 -> other -> Company2 is more positive for Company2, than\nfor Company1. As Company2 was featured on Company1 website.\n
\nSometimes the `other` category can have additional information via the source_category attribute\ndepending on where it was found. An example of such a source_category would be `cookie_section`,\nwhich is explained further below. Such connections could be evaluated differently.\n"}],"description":"`Connection` category."},"confidence":{"type":["null","number"],"maximum":1,"minimum":0,"description":"A numerical score between 0 and 1 that represents PredictLeads’ estimated reliability of a `Connection`."},"source_url":{"type":["null","string"],"format":"uri","description":"URL where `Connection` information was found."},"last_seen_at":{"type":"string","format":"date-time","example":"2024-09-25T16:09:53Z","description":"Date & time (ISO 8601) of when the `Connection` was last seen."},"first_seen_at":{"type":"string","format":"date-time","example":"2024-09-25T16:09:53Z","description":"Date & time (ISO 8601) of when the `Connection` was first seen."},"source_category":{"enum":["undefined","partner_page","vendor_page","registration_page","integration_page","investor_page","about_page","demo_page","parent_page","case_study_page","testimonial_page","manual_input","domain_redirect","same_subpage","partner_section","vendor_section","integration_section","investor_section","parent_section","case_study_section","testimonial_section","social_section","published_in_section","vendor_inverse_section","investor_inverse_section","parent_inverse_section","footer","header","vendor_inverse_page","cookie_section","badge_section"],"description":"Describes source where the `Connection` category was found.","externalDocs":{"url":"/guide/connections_dataset/source_categories","description":"Read more about source categories..."}},"individual_source_url":{"type":["null","string"],"format":"uri","description":"URL where Connection` additional information was found."}},"description":"Attributes of the `Connection` object."},"relationships":{"type":"object","required":["company1","company2","technology"],"properties":{"company1":{"type":"object","title":"ConnectionToCompanyLiteRelationship","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."},"company2":{"type":"object","title":"ConnectionToCompanyLiteRelationship","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."},"technology":{"type":"object","title":"ConnectionToTechnologyLiteRelationship","required":["data"],"properties":{"data":{"oneOf":[{"type":"object","required":["id","type"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the included `TechnologyLite` object."},"type":{"const":"technology","description":"Type of the included `TechnologyLite` object."}}},{"type":"null"}]}},"description":"The data contains a reference to related `TechnologyLite` object listed in the `included` property."}},"description":"The data contains references to related objects listed in the `included` property.\nOrder of companies is guaranteed and necessary to preserve the meaning of the\n`category`. For example: Company1 is a `vendor` to Company2.\n"}},"description":"The `Connection` object."}},"meta":{"type":"object","required":["schema_version","record_state"],"properties":{"count":{"type":"integer","example":344,"description":"Total number of results.\n
\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 `ConnectionsDataset` object.\n"},"included":{"type":"array","items":{"oneOf":[{"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."},{"type":"object","title":"TechnologyLite","required":["id","type","attributes"],"properties":{"id":{"type":"string","format":"uuid","description":"ID of the `TechnologyLite` object."},"type":{"const":"technology","description":"Type of the `TechnologyLite` object."},"attributes":{"type":"object","required":["name"],"properties":{"name":{"type":"string"}},"description":"Attributes of the `TechnologyLite` object."}},"description":"The `TechnologyLite` object."}]},"description":"Contains objects referenced in property `relationships`."}},"description":"Since 2019, PredictLeads has detected over 345 million business connections between companies globally.\nThe Company Connections Dataset describes relationships between some 60 million companies.\n

\nConnections are sourced from different subpages on the website, such as Main, Customers, Partners, Integrations,\nCase Study, Testimonials, Suppliers, Portfolio, and identified through image recognition of company logos.\n

\nThe Connections Dataset includes fields such as Connection Category, Source Category, Source URL, Context,\nFirst Seen At, Last Seen At, and other Connection information.\n"},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.040000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.040000/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.040000","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.040000","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yTXTR93H7JKFVCc_wBVP7","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.040000","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 paginated list of categorized business connections (partnerships, integrations, vendor relationships, etc.) for a specified company, including context and source URLs.","exampleAgentPrompt":"Pull all the business connections for stripe.com from PredictLeads — I want to see their partnerships, vendor relationships, and integrations, filtered to only the ones first detected since January 2024.","exampleUseCases":[{"title":"Mapping a competitor's partner ecosystem","prompt":"Can you get me all the partnership and integration connections for hubspot.com from PredictLeads? I want to understand who they work closely with and what their ecosystem looks like."},{"title":"Vetting a potential vendor's customer list","prompt":"Look up the vendor connections for salesforce.com — I want to see which companies list Salesforce as one of their vendors or trusted partners, with context on how those relationships are described."},{"title":"Tracking new integrations for a SaaS tool","prompt":"Fetch the integration connections for segment.com that were first seen after March 1, 2024 — I want to know which new platforms or tools they've announced integrations with recently."}],"resultDescription":"A paginated JSON array of Connection objects, each including a unique ID, relationship category (e.g. partner, vendor, integration, customer), a natural-language context summary of how the two companies work together, source URL and individual source URL, first/last seen timestamps, confidence score, and source category. Included sidecar objects provide company names and domains for both parties in the relationship.","failureModes":["Invalid or unknown company_id_or_domain returns empty data array","Invalid category enum value may return a 400 or empty results","Pagination beyond available records returns empty data","Rate limiting or authentication failure returns 401/429","Truncated or missing context if source page was not parseable"],"whenToPreferThis":"Use this endpoint when you need structured, categorized relationship data between a specific company and its business partners, vendors, customers, or integration targets — especially when you need source provenance, categorized relationship types, and date-range filtering. Prefer this over generic web search when you need clean, machine-readable B2B relationship data at scale across 120M+ companies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T15:07:05.658Z","isFirstParty":false,"canonicalSlug":"agents-predictleads-com-predictleads-get-company-connections-e77b9304"}