---
title: "Discover Public Companies Connections"
method: GET
path: "/discover/public_companies/connections"
tags: ["Connections Dataset"]
---

# Discover Public Companies Connections

`GET /discover/public_companies/connections`

## Request

- Base URL: `https://predictleads.com/api/v3`
- URL: `https://predictleads.com/api/v3/discover/public_companies/connections`
- Auth: one of:
  - API key in header `X-API-KEY` and API key in header `X-API-TOKEN`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://oauth.predictleads.com/token`

Returns the `vendor` and `partner` Connections of publicly traded companies, ordered by the `first_seen_at`, descending.

## Query parameters

- `first_seen_at_from` string, date
- `first_seen_at_until` string, date
- `page` integer
- `limit` integer

## Response `200`

Request was successfully processed.

- ConnectionsDataset: Since 2019, PredictLeads has detected over 345 million business connections between companies globally. The Company Connections Dataset describes relationships between some 60 million companies. <br><br> Connections are sourced from different subpages on the website, such as Main, Customers, Partners, Integrations, Case Study, Testimonials, Suppliers, Portfolio, and identified through image recognition of company logos. <br><br> The Connections Dataset includes fields such as Connection Category, Source Category, Source URL, Context, First Seen At, Last Seen At, and other Connection information.
  - `data` Connection[], required (unresolved $ref)
  - `included` union[], required: Contains objects referenced in property `relationships`.
    - union
      - CompanyLite (unresolved $ref)
      - TechnologyLite (unresolved $ref)
  - `meta` object: Meta information about `ConnectionsDataset` object.
    - `schema_version` string, required: Represents schema version of objects.
    - `record_state` 'active', required: Represents record state of objects.
    - `count` integer: Total number of results. <br> **NOTE**: Only included in API responses when the request parameter `page` is provided, for performance reasons.

## Other responses

- `400`: Invalid request body or parameters.
- `401`: Authentication credentials are invalid or API subscription is not activated.
- `402`: Exceeded the monthly request limit.
- `403`: Request rate over limit.
- `404`: Record not found.
- `422`: Provided data failed to validate.
- `429`: Too many requests.
- `500`: Internal server error.
- `503`: Service temporarily unavailable.

## Changes

- **2026-10-09** `94475b6f17a8`: 2 warning
  - added the new `demo_page` enum value to the `data/items/attributes/source_category` response property for the response status `200`
  - added the new `registration_page` enum value to the `data/items/attributes/source_category` response property for the response status `200`
- **2026-10-03** `ff3b5bffadc5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/predictleads/apis/predictleads-api-reference/changes/discover/public_companies/connections/get.md)

---

[API](https://skmtc.dev/predictleads/apis/predictleads-api-reference.md) - [All operations](https://skmtc.dev/predictleads/apis/predictleads-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/predictleads/apis/predictleads-api-reference/revisions/ccb9fec6a710?raw)