# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for APIs.io Insights API
  version: 1.0.0
extends: openapi/apis-io-insights-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/insights'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the insights overview
      effect: read
      questions:
      - How many companies and dimensions does the insights data cover?
      - Can I get a one-call overview of the demand-side insights dataset?
      instructions:
      - text: Give me the insights overview.
      - text: Summarize company, dimension and adoption counts from insights.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/dimensions'].get
  update:
    x-apievangelist-phrasing:
      intent: Rank technology investment dimensions
      effect: read
      questions:
      - Which of the 40 tracked dimensions show signal at the most companies?
      - Can I page through every investment dimension in ranked order?
      instructions:
      - text: Rank the investment dimensions by how many companies show signal.
      - text: Show the top {limit} investment dimensions.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/adoption'].get
  update:
    x-apievangelist-phrasing:
      intent: Rank services, tools and standards by adoption
      effect: read
      questions:
      - Which tools and standards are adopted by the most companies?
      - Can I filter adoption rankings to just services or just standards?
      instructions:
      - text: Rank technologies of type {type} by adoption.
        slots:
          type: query.type
      - text: Show the most widely adopted services, tools and standards.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/industries'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the insights industry rollup
      effect: read
      questions:
      - Which sectors are profiled in insights, and how many companies are in each?
      - What is the company count per industry in the demand-side data?
      instructions:
      - text: Show the insights industry rollup.
      - text: List profiled sectors with their company counts.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/companies'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse profiled companies
      effect: read
      questions:
      - Which profiled companies show the strongest technology-readiness signal?
      - Can I find a profiled company by name?
      instructions:
      - text: Find profiled companies named {q}.
        slots:
          q: query.q
      - text: List profiled companies ranked by readiness signal.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/company/{slug}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one company's demand-side profile
      effect: read
      questions:
      - What technology stack and investment signals does a specific company have?
      - Can I see a company's per-quarter insight history?
      instructions:
      - text: Get the demand-side profile for company {slug}.
        slots:
          slug: path.slug
      - text: Show the adopted stack and dimension profile of {slug}.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/company/{slug}/gaps'].get
  update:
    x-apievangelist-phrasing:
      intent: Find a company's weakest dimensions
      effect: read
      questions:
      - Where is a company thin, so a vendor could sell in?
      - Which investment dimensions does a company score lowest on?
      instructions:
      - text: Show the weakest investment dimensions for company {slug}.
        slots:
          slug: path.slug
      - text: Find where {slug} is thin.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/insights/company/{slug}/match'].get
  update:
    x-apievangelist-phrasing:
      intent: Match providers to a company's stack
      effect: read
      questions:
      - Which catalog providers show up in a company's adopted technology stack?
      - Can I rank the providers a company already uses by rating?
      instructions:
      - text: Match catalog providers to the stack of company {slug}.
        slots:
          slug: path.slug
      - text: List rated providers found in {slug}'s adopted stack.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'