ZoomInfo Insights API

openapi: 3.2.0
info:
  title: Copilot API V1 Insights API
  version: '1.0'
  contact:
    name: ZoomInfo Customer Support
    email: help@zoominfo.com
  description: Copilot API for interacting with the Copilot related services.
servers:
- url: https://api.zoominfo.com/gtm
  description: Base URL for the Copilot API
security:
- OAuth2Auth: []
tags:
- name: Insights
paths:
  /copilot/v1/companies/insights:
    post:
      operationId: InsightsInterface_getCompanyInsightsByType
      summary: Get insights by type
      description: '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'
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/CompanyInsightsByTypeResponse'
        '400':
          description: Bad Request
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
        '429':
          description: Too Many Requests
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel'
      tags:
      - Insights
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/CompanyInsightsByTypeRequest'
        description: The request body containing company IDs(mandatory) and insight type filters.
      security:
      - OAuth2Auth:
        - api:insights:read
      x-additional-content-types:
      - application/json
      x-api-roles:
      - fea:gtmpl
components:
  schemas:
    CompetitorIntentInsight:
      type: object
      required:
      - ziCompanyId
      - signalId
      - signalType
      - signalPayload
      properties:
        id:
          type: integer
          format: int64
          description: Unique id for the insight.
        ziCompanyId:
          type: integer
          format: int64
          description: Company id.
        signalId:
          type: string
          description: Signal id.
        signalType:
          type: string
          description: Type of the signal.
          default: zi.intent.competitor.spike
          pattern: zi.intent.competitor.spike
        signalPayload:
          allOf:
          - $ref: '#/components/schemas/CompetitorIntentSignalPayload'
          description: Structured payload containing signal-specific data based on the signal type.
        insightDate:
          type: string
          format: date-time
          description: Date of the insight.
        expiresAt:
          type: string
          format: date-time
          description: Expiration date of the insight.
        createdAt:
          type: string
          format: date-time
          description: Date of creation of the insight.
      description: Competitor intent insight model
    WebsightsInsight:
      type: object
      required:
      - ziCompanyId
      - signalId
      - signalType
      - signalPayload
      properties:
        id:
          type: integer
          format: int64
          description: Unique id for the insight.
        ziCompanyId:
          type: integer
          format: int64
          description: Company id.
        signalId:
          type: string
          description: Signal id.
        signalType:
          type: string
          description: Type of the signal.
          default: zi.websights
          pattern: zi.websights
        signalPayload:
          allOf:
          - $ref: '#/components/schemas/WebsightsSignalPayload'
          description: Structured payload containing signal-specific data based on the signal type.
        insightDate:
          type: string
          format: date-time
          description: Date of the insight.
        expiresAt:
          type: string
          format: date-time
          description: Expiration date of the insight.
        createdAt:
          type: string
          format: date-time
          description: Date of creation of the insight.
      description: Websights insight model
    MpocChangeSignalPayload:
      type: object
      required:
      - displayText
      - date
      - ziCompanyId
      - ziContactId
      - name
      - changeType
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        ziCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company id.
        ziContactId:
          type: integer
          format: int64
          description: ZoomInfo contact id for the person.
        name:
          type: string
          description: Name of the person associated with this signal.
        title:
          type: string
          description: Person's job title.
        isPersonOfInterest:
          type: boolean
          description: Indicates if this person was identified as a contact of interest.
        isCLevel:
          type: boolean
          description: Indicates if the person holds a C-level executive position.
        inBuyingGroup:
          type: boolean
          description: Indicates if the person is part of an identified buying committee or decision-making group.
        changeType:
          type: string
          description: Specific type of change that triggered this signal.
        previousCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company ID of the person's previous employer.
        previousTitle:
          type: string
          description: Person's previous job title.
        previousCompanyName:
          type: string
          description: Name of the company where the person was previously employed.
      description: MPOC change signal payload.
    ProjectSignalPayload:
      type: object
      required:
      - displayText
      - date
      - text
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        text:
          type: string
          description: The text content of the signal.
      description: Project signal payload.
    CxoChangeSignalPayload:
      type: object
      required:
      - displayText
      - date
      - ziCompanyId
      - ziContactId
      - name
      - changeType
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        ziCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company id.
        ziContactId:
          type: integer
          format: int64
          description: ZoomInfo contact id for the person.
        name:
          type: string
          description: Name of the person associated with this signal.
        title:
          type: string
          description: Person's job title.
        isPersonOfInterest:
          type: boolean
          description: Indicates if this person was identified as a contact of interest.
        isCLevel:
          type: boolean
          description: Indicates if the person holds a C-level executive position.
        inBuyingGroup:
          type: boolean
          description: Indicates if the person is part of an identified buying committee or decision-making group.
        changeType:
          type: string
          description: Specific type of change that triggered this signal.
        previousCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company ID of the person's previous employer.
        previousTitle:
          type: string
          description: Person's previous job title.
        previousCompanyName:
          type: string
          description: Name of the company where the person was previously employed.
      description: CXO change signal payload.
    AliLocation:
      type: object
      required:
      - location
      - buyersCount
      properties:
        location:
          type: string
          description: Geographic location name.
        buyersCount:
          type: integer
          format: int64
          description: Number of active buyers detected.
      description: Account Level Intent (ALI) location information.
    MASignalPayload:
      type: object
      required:
      - displayText
      - date
      - text
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        text:
          type: string
          description: The text content of the signal.
      description: M&A signal payload.
    BuyingCommitteeChangeSignalPayload:
      type: object
      required:
      - displayText
      - date
      - ziCompanyId
      - ziContactId
      - name
      - changeType
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        ziCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company id.
        ziContactId:
          type: integer
          format: int64
          description: ZoomInfo contact id for the person.
        name:
          type: string
          description: Name of the person associated with this signal.
        title:
          type: string
          description: Person's job title.
        isPersonOfInterest:
          type: boolean
          description: Indicates if this person was identified as a contact of interest.
        isCLevel:
          type: boolean
          description: Indicates if the person holds a C-level executive position.
        inBuyingGroup:
          type: boolean
          description: Indicates if the person is part of an identified buying committee or decision-making group.
        changeType:
          type: string
          description: Specific type of change that triggered this signal.
        previousCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company ID of the person's previous employer.
        previousTitle:
          type: string
          description: Person's previous job title.
        previousCompanyName:
          type: string
          description: Name of the company where the person was previously employed.
      description: Buying committee change signal payload.
    CompanyInsightsByTypeResponse:
      type: object
      required:
      - data
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CompanyInsightsByTypeResponseResource'
          description: The primary data of the document
      description: Response model for retrieving company insights by type.
    CompanyInsightsByTypeRequestAttributes:
      type: object
      required:
      - ziCompanyIds
      properties:
        ziCompanyIds:
          type: array
          items:
            type: integer
            format: int64
          maxItems: 50
          description: List of ZoomInfo company IDs to retrieve insights for (maximum 50 companies per request).
        signalTypes:
          type: array
          items:
            $ref: '#/components/schemas/SignalType'
          description: Optional filter for specific insight types. If not provided or empty, returns insights of all available types.
      description: Request attributes for retrieving company insights filtered by signal type.
    ZoomInfo.Core.Foundations.ErrorSourceModel:
      type: object
      properties:
        cookie:
          type: string
          description: Identifies the cookie name that caused the issue
        header:
          type: string
          description: Identifies the header name that caused the error
        pointer:
          type: string
          description: An RFC 6901 compliant JSON pointer to the entity in the request body that caused the error
        parameter:
          type: string
          description: The name of the path or query parameter that caused the error
    MAInsight:
      type: object
      required:
      - ziCompanyId
      - signalId
      - signalType
      - signalPayload
      properties:
        id:
          type: integer
          format: int64
          description: Unique id for the insight.
        ziCompanyId:
          type: integer
          format: int64
          description: Company id.
        signalId:
          type: string
          description: Signal id.
        signalType:
          type: string
          description: Type of the signal.
          default: zi.m&a
          pattern: zi.m&a
        signalPayload:
          allOf:
          - $ref: '#/components/schemas/MASignalPayload'
          description: Structured payload containing signal-specific data based on the signal type.
        insightDate:
          type: string
          format: date-time
          description: Date of the insight.
        expiresAt:
          type: string
          format: date-time
          description: Expiration date of the insight.
        createdAt:
          type: string
          format: date-time
          description: Date of creation of the insight.
      description: M&A insight model
    PartnershipInsight:
      type: object
      required:
      - ziCompanyId
      - signalId
      - signalType
      - signalPayload
      properties:
        id:
          type: integer
          format: int64
          description: Unique id for the insight.
        ziCompanyId:
          type: integer
          format: int64
          description: Company id.
        signalId:
          type: string
          description: Signal id.
        signalType:
          type: string
          description: Type of the signal.
          default: zi.partnership
          pattern: zi.partnership
        signalPayload:
          allOf:
          - $ref: '#/components/schemas/PartnershipSignalPayload'
          description: Structured payload containing signal-specific data based on the signal type.
        insightDate:
          type: string
          format: date-time
          description: Date of the insight.
        expiresAt:
          type: string
          format: date-time
          description: Expiration date of the insight.
        createdAt:
          type: string
          format: date-time
          description: Date of creation of the insight.
      description: Partnership insight model
    G2SignalPayload:
      type: object
      required:
      - displayText
      - date
      - type
      - subject
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        type:
          type: string
          description: 'The type of G2 page visited. One of: ''Category'', ''Compare'', ''Competitors'', ''Licensed Content'', ''Pricing Page'', ''Product Reference Page'', ''Profile''.'
        subject:
          type: string
          description: 'Label combining type and content in the format ''{type}: {content}'' (e.g. ''Competitors: Acme Corp'', ''Category: Sales Intelligence'').'
      description: G2 signal payload.
    FormCompleteSignalPayload:
      type: object
      required:
      - displayText
      - date
      - ziCompanyId
      - ziContactId
      - name
      - formName
      - formStatus
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        ziCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company id.
        ziContactId:
          type: integer
          format: int64
          description: ZoomInfo contact id for the person.
        name:
          type: string
          description: Name of the person associated with this signal.
        title:
          type: string
          description: Person's job title.
        isPersonOfInterest:
          type: boolean
          description: Indicates if this person was identified as a contact of interest.
        isCLevel:
          type: boolean
          description: Indicates if the person holds a C-level executive position.
        inBuyingGroup:
          type: boolean
          description: Indicates if the person is part of an identified buying committee or decision-making group.
        formName:
          type: string
          description: The customer-defined name of the submitted form, as configured in ZoomInfo FormComplete.
        formStatus:
          allOf:
          - $ref: '#/components/schemas/FormStatus'
          description: Status of the form.
      description: Form complete signal payload.
    MarketingCampaignsInsight:
      type: object
      required:
      - ziCompanyId
      - signalId
      - signalType
      - signalPayload
      properties:
        id:
          type: integer
          format: int64
          description: Unique id for the insight.
        ziCompanyId:
          type: integer
          format: int64
          description: Company id.
        signalId:
          type: string
          description: Signal id.
        signalType:
          type: string
          description: Type of the signal.
          default: zi.marketingcampaigns
          pattern: zi.marketingcampaigns
        signalPayload:
          allOf:
          - $ref: '#/components/schemas/MarketingCampaignsSignalPayload'
          description: Structured payload containing signal-specific data based on the signal type.
        insightDate:
          type: string
          format: date-time
          description: Date of the insight.
        expiresAt:
          type: string
          format: date-time
          description: Expiration date of the insight.
        createdAt:
          type: string
          format: date-time
          description: Date of creation of the insight.
      description: Marketing campaigns insight model
    IPOInsight:
      type: object
      required:
      - ziCompanyId
      - signalId
      - signalType
      - signalPayload
      properties:
        id:
          type: integer
          format: int64
          description: Unique id for the insight.
        ziCompanyId:
          type: integer
          format: int64
          description: Company id.
        signalId:
          type: string
          description: Signal id.
        signalType:
          type: string
          description: Type of the signal.
          default: zi.ipo
          pattern: zi.ipo
        signalPayload:
          allOf:
          - $ref: '#/components/schemas/IPOSignalPayload'
          description: Structured payload containing signal-specific data based on the signal type.
        insightDate:
          type: string
          format: date-time
          description: Date of the insight.
        expiresAt:
          type: string
          format: date-time
          description: Expiration date of the insight.
        createdAt:
          type: string
          format: date-time
          description: Date of creation of the insight.
      description: IPO insight model
    DivestitureSignalPayload:
      type: object
      required:
      - displayText
      - date
      - text
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        text:
          type: string
          description: The text content of the signal.
      description: Divestiture signal payload.
    PersonBasedNewsSignalPayload:
      type: object
      required:
      - displayText
      - date
      - ziCompanyId
      - ziContactId
      - name
      - description
      - source
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        ziCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company id.
        ziContactId:
          type: integer
          format: int64
          description: ZoomInfo contact id for the person.
        name:
          type: string
          description: Name of the person associated with this signal.
        title:
          type: string
          description: Person's job title.
        isPersonOfInterest:
          type: boolean
          description: Indicates if this person was identified as a contact of interest.
        isCLevel:
          type: boolean
          description: Indicates if the person holds a C-level executive position.
        inBuyingGroup:
          type: boolean
          description: Indicates if the person is part of an identified buying committee or decision-making group.
        description:
          type: string
          description: Summary of the news article or story featuring this contact.
        source:
          type: string
          description: Name of the publication or outlet that published the news (e.g. 'TechCrunch', 'Forbes').
      description: Person based news signal payload.
    MarketingCampaignsSignalPayload:
      type: object
      required:
      - displayText
      - date
      - ziCompanyId
      - description
      - campaignName
      - campaignAudienceCompanyName
      - clicks
      - impressions
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        ziCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company id.
        description:
          type: string
          description: Summary of the marketing campaign and its targeting criteria.
        campaignName:
          type: string
          description: Name of the marketing campaign.
        campaignAudienceCompanyName:
          type: string
          description: Name of the company targeted by the campaign.
        clicks:
          type: integer
          format: int64
          description: Number of clicks the campaign received.
        impressions:
          type: integer
          format: int64
          description: Number of impressions the campaign received.
      description: Marketing campaigns signal payload.
    G2Insight:
      type: object
      required:
      - ziCompanyId
      - signalId
      - signalType
      - signalPayload
      properties:
        id:
          type: integer
          format: int64
          description: Unique id for the insight.
        ziCompanyId:
          type: integer
          format: int64
          description: Company id.
        signalId:
          type: string
          description: Signal id.
        signalType:
          type: string
          description: Type of the signal.
          default: zi.g2
          pattern: zi.g2
        signalPayload:
          allOf:
          - $ref: '#/components/schemas/G2SignalPayload'
          description: Structured payload containing signal-specific data based on the signal type.
        insightDate:
          type: string
          format: date-time
          description: Date of the insight.
        expiresAt:
          type: string
          format: date-time
          description: Expiration date of the insight.
        createdAt:
          type: string
          format: date-time
          description: Date of creation of the insight.
      description: G2 insight model
    UpcomingRenewalSignalPayload:
      type: object
      required:
      - displayText
      - date
      - renewalDate
      - signalId
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        renewalDate:
          type: string
          format: date-time
          description: UTC timestamp of when the renewal is due.
        signalId:
          type: string
          description: Unique identifier for this upcoming renewal signal instance.
      description: Upcoming renewal signal payload.
    FormCompleteInsight:
      type: object
      required:
      - ziCompanyId
      - signalId
      - signalType
      - signalPayload
      properties:
        id:
          type: integer
          format: int64
          description: Unique id for the insight.
        ziCompanyId:
          type: integer
          format: int64
          description: Company id.
        signalId:
          type: string
          description: Signal id.
        signalType:
          type: string
          description: Type of the signal.
          default: zi.formcomplete
          pattern: zi.formcomplete
        signalPayload:
          allOf:
          - $ref: '#/components/schemas/FormCompleteSignalPayload'
          description: Structured payload containing signal-specific data based on the signal type.
        insightDate:
          type: string
          format: date-time
          description: Date of the insight.
        expiresAt:
          type: string
          format: date-time
          description: Expiration date of the insight.
        createdAt:
          type: string
          format: date-time
          description: Date of creation of the insight.
      description: Form complete insight model
    TechnologyStatus:
      type: string
      enum:
      - ADD
      - DROP
      description: Indicates whether a technology was added to the company's tech stack.
      x-enumDescriptions:
        ADD: The company has recently adopted this technology into their tech stack.
    TrustRadiusActivitySource:
      type: string
      enum:
      - Category
      - Competitor
      - Licensed Product
      description: Source indicating where the TrustRadius activity originated.
      x-enumDescriptions:
        CATEGORY: Activity originated from browsing a product category on TrustRadius.
        COMPETITOR: Activity originated from viewing a competitor's product page.
        LICENSED_PRODUCT: Activity originated from a product page that the tenant has licensed on TrustRadius.
    PersonWebsightsSignalPayload:
      type: object
      required:
      - displayText
      - date
      - ziCompanyId
      - ziContactId
      - name
      - url
      - intentLevel
      properties:
        displayText:
          type: string
          description: Text describing this signal for display purposes.
        date:
          type: string
          format: date-time
          description: UTC timestamp when the signal event was originally recorded or detected.
        ziCompanyId:
          type: integer
          format: int64
          description: ZoomInfo company id.
        ziContactId:
          type: integer
          format: int64
          description: ZoomInfo contact id for the person.
        name:
          type: string
          description: Name of the person associated with this signal.
        title:
          type: string
          description: Person's job title.
        isPersonOfInterest:
          type: boolean
          description: Indicates if this person was identified as a contact of interest.
        isCLevel:
          type: boolean
          description: Indicates if the person holds a C-level executive position.
        inBuyingGroup:
          type: boolean
          description: Indicates if the person is part of an identified buying committee or decision-making group.
        url:
          type: string
 

# --- truncated at 32 KB (111 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoominfo/refs/heads/main/openapi/zoominfo-insights-api-openapi.yml