# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for G2 Buyer Intent API
  version: 1.0.0
extends: openapi/g2-buyer-intent-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/api/sandbox/products/{subject_product_id}/buyer_intent'].get
  update:
    x-apievangelist-phrasing:
      intent: Explore sample buyer intent data in the sandbox
      effect: read
      questions:
      - Is there a sandbox where I can try buyer intent queries without a scope?
      - What older buyer intent data can I test against before I get production access?
      - Can I practice grouping intent by company domain on limited sandbox data for my product?
      instructions:
      - text: Query sandbox buyer intent for product {subject_product_id}.
        slots:
          subject_product_id: path.subject_product_id
      - text: Run a sandbox intent query for {subject_product_id} grouped by {dimensions} measuring {measures}.
        slots:
          subject_product_id: path.subject_product_id
          dimensions: query.dimensions
          measures: query.measures
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/buyer_intent'].get
  update:
    x-apievangelist-phrasing:
      intent: Query buyer intent across several products
      effect: read
      questions:
      - Can I pull buyer intent for several of my products in one request?
      - Which companies are researching any of my assigned products right now?
      - What does cross-product buyer intent look like on G2 when I don't pick a single product?
      instructions:
      - text: Query buyer intent across products {subject_product_ids}.
        slots:
          subject_product_ids: query.subject_product_ids
      - text: Show buyer intent for all my assigned products grouped by {dimensions}.
        slots:
          dimensions: query.dimensions
      - text: Pull multi-product intent with measures {measures} sorted by {sort}.
        slots:
          measures: query.measures
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/products/{subject_product_id}/buyer_intent'].get
  update:
    x-apievangelist-phrasing:
      intent: Query live buyer intent for one product
      effect: read
      questions:
      - Which companies are showing buying intent for my product this month?
      - Can I group live intent activity for my product by company and day?
      - How do I filter production buyer intent for one product by company domain?
      instructions:
      - text: Get live buyer intent for product {subject_product_id}.
        slots:
          subject_product_id: path.subject_product_id
      - text: Break down production intent for {subject_product_id} by {dimensions} with filters {dimension_filters}.
        slots:
          subject_product_id: path.subject_product_id
          dimensions: query.dimensions
          dimension_filters: query.dimension_filters
      method: generated
      generated: '2026-10-01'