# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for G2 Products API
  version: 1.0.0
extends: openapi/g2-products-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/v2/products'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse and search software products
      effect: read
      questions:
      - Can I search products by name or keyword?
      - Which products in a category have at least 100 reviews?
      - What products does a given vendor list on G2?
      instructions:
      - text: Search products matching {query}.
        slots:
          query: query.filter[query]
      - text: List products in category {category_id} with at least {count} reviews.
        slots:
          category_id: query.filter[category_id][]
          count: query.filter[review_count_gteq]
      - text: Show products from vendor {vendor_name}.
        slots:
          vendor_name: query.filter[vendor_name]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/products/{product_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Show one product's details
      effect: read
      questions:
      - What details are listed for a single product?
      - Can I fetch one product by its ID or slug with related records?
      instructions:
      - text: Show product {product_id}.
        slots:
          product_id: path.product_id
      - text: Get product {product_id} including {include}.
        slots:
          product_id: path.product_id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/users/me/products'].get
  update:
    x-apievangelist-phrasing:
      intent: List products my account owns
      effect: read
      questions:
      - Which products does my account own and what subscription info do they have?
      - Can I check ownership details for one of my own products by slug?
      instructions:
      - text: List the products my account owns.
      - text: Show my owned product with slug {slug}.
        slots:
          slug: query.filter[slug][]
      method: generated
      generated: '2026-10-01'