--- title: "Get insights by type" method: POST path: "/copilot/v1/companies/insights" tags: ["Insights"] --- # Get insights by type `POST /copilot/v1/companies/insights` ## Request - Base URL: `https://api.zoominfo.com/gtm` - URL: `https://api.zoominfo.com/gtm/copilot/v1/companies/insights` - Auth: OAuth 2 - Authorization code: `https://login.zoominfo.com` - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:insights:read` Retrieve sales intelligence signals for up to 50 companies, filtered by signal type. Signals include funding events, leadership changes, intent spikes, hiring anomalies, and more. # Insights API - Introduction The **Insights API** provides programmatic access to ZoomInfo's curated intelligence layer — actionable data about customer activity that matters most to your business. **Insights** are automatically filtered for relevance, recency, and context based on your team's specific focus areas. This means you receive high-priority updates like decision-maker job changes at target accounts, intent spikes in your buying groups, or website visits from key personas — without the noise of every global data point. ## Why Use Insights? **Insights** enable two critical workflows for modern go-to-market teams: - **Revenue Operations**: Orchestrate automated workflows based on meaningful account changes. For example, route leads when employment changes bring a known champion to a target account, send alerts when intent signals spike for your product category, or update CRM records when funding announcements or new projects signal budget availability. - **Sales Teams**: Prioritize accounts based on key buying signals, and reach out in real time. Focus on accounts where specific decision-makers have visited your website, where intent data shows they're actively researching competitors, or where employment changes indicate new leadership in key buying roles — all without sifting through irrelevant updates. ## Data Sources **Insights** are powered by multiple data sources, including: - **ZoomInfo Data**: Intent signals, WebSights visitor intelligence, organizational changes, and business news from public sources - **First-Party Data**: CRM activity, meeting intelligence, and email engagement from your systems - **Partner Signals**: Buyer intent and product research activity from G2, TrustRadius, and other platforms ## Available Insight Types For a complete list of available Insights and their filtering criteria, see the [ZoomInfo Signals Glossary](https://eng7e.seismic.com/i/7PLUSSIGNTOIgJwEd0YNcFquYltStcWzmeup___own6jqymt85zpqZZ9Ml9dbioKdxvA1oAnox7K5rO5cIjVfG5FnDjPSyasqgaogzeKTK___iPLUSSIGNQTfCOy3CcvhCmqnpK9yYiDadIILi). ## Common Use Cases The Insights API empowers you to surface and act on customer intelligence in any application or workflow that makes sense for your business: - **Account Prioritization & Routing**: Orchestrate scoring, segmentation, and assignment workflows that connect insights across systems to route accounts to the right sellers at the right time - **Workflow Automation**: Trigger external systems like email platforms, notification tools, or data warehouses when specific insight types occur - **Real-Time Alerting**: Create custom notification rules based on your team's unique prioritization logic - **Custom Dashboards**: Build executive views of high-priority account activity across your entire portfolio ## Request body - CompanyInsightsByTypeRequest: Request model for retrieving company insights by type. - `data` CompanyInsightsSearch, required: Company insights by type request resource. - `type` string, required: The type of the resource - `attributes` CompanyInsightsByTypeRequestAttributes, required: Request attributes for retrieving company insights filtered by signal type. - `ziCompanyIds` integer[], required: List of ZoomInfo company IDs to retrieve insights for (maximum 50 companies per request). - `signalTypes` SignalType[]: Optional filter for specific insight types. If not provided or empty, returns insights of all available types. ## Response `200` Success - CompanyInsightsByTypeResponse: Response model for retrieving company insights by type. - `data` CompanyInsightsByTypeResponseResource[], required: The primary data of the document - `id` string, required: The unique identifier for the resource - `type` string, required: The type of the resource - `attributes` CompanyInsight, required: Attributes for company insight. - `insights` InsightUnion[], required: Array of insights for this company. - union - object: Funding insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` FundingSignalPayload, required: Funding signal payload - represents company funding events. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: CXO change insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` CxoChangeSignalPayload, required: CXO change signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Scoops insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` ScoopsSignalPayload, required: Scoops signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Websights insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` WebsightsSignalPayload, required: Websights signal payload - represents web activity insights. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Buying committee change insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` BuyingCommitteeChangeSignalPayload, required: Buying committee change signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Account level intent insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` AccountLevelIntentSignalPayload, required: Account level intent signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Competitor intent insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` CompetitorIntentSignalPayload, required: Competitor intent signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: MPOC change insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` MpocChangeSignalPayload, required: MPOC change signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: G2 insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` G2SignalPayload, required: G2 signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: TrustRadius insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` TrustRadiusSignalPayload, required: TrustRadius signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Anomalous hiring insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` AnomalousHiringSignalPayload, required: Anomalous hiring signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Form complete insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` FormCompleteSignalPayload, required: Form complete signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Podcast mentions insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` PodcastMentionsSignalPayload, required: Podcast mentions signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Marketing campaigns insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` MarketingCampaignsSignalPayload, required: Marketing campaigns signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Technology insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` TechnologySignalPayload, required: Technology signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Senior job postings insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` SeniorJobPostingsSignalPayload, required: Senior job postings signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Person websights insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` PersonWebsightsSignalPayload, required: Person websights signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Person based news insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` PersonBasedNewsSignalPayload, required: Person based news signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Won deal insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` WonDealSignalPayload, required: Won deal signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: New contact previously worked for customer insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` NewContactPreviouslyWorkedForCustomerSignalPayload, required: New contact previously worked for customer signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Person change insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` PersonChangeSignalPayload, required: Base model for person-related signal payloads with change tracking. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Upcoming meeting insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` UpcomingMeetingSignalPayload, required: Upcoming meeting signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Low active contacts insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` LowActiveContactsSignalPayload, required: Low active contacts signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: No decision maker insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` NoDecisionMakerSignalPayload, required: No decision maker signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: No post meeting follow up insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` NoPostMeetingFollowUpSignalPayload, required: No post meeting follow up signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Upcoming renewal insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` UpcomingRenewalSignalPayload, required: Upcoming renewal signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: M&A insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` MASignalPayload, required: M&A signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Product launch insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` ProductLaunchSignalPayload, required: Product launch signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Earnings insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` EarningsSignalPayload, required: Earnings signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Partnership insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` PartnershipSignalPayload, required: Partnership signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Layoffs insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` LayoffsSignalPayload, required: Layoffs signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Pain point insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` PainPointSignalPayload, required: Pain point signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Divestiture insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` DivestitureSignalPayload, required: Divestiture signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: IPO insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` IPOSignalPayload, required: IPO signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Award insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` AwardSignalPayload, required: Award signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. - object: Project insight model - `id` integer: Unique id for the insight. - `ziCompanyId` integer, required: Company id. - `signalId` string, required: Signal id. - `signalType` string, required: Type of the signal. - `signalPayload` ProjectSignalPayload, required: Project signal payload. - … - `insightDate` string, date-time: Date of the insight. - `expiresAt` string, date-time: Expiration date of the insight. - `createdAt` string, date-time: Date of creation of the insight. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `429`: Too Many Requests --- [API](https://skmtc.dev/zoominfo/apis/copilot-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/copilot-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/copilot-api-v1/revisions/f737ab239c2a?raw)