Microsoft Azure Microsoft Marketplace Search API — Public-Suggestions

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Microsoft Marketplace Search API — Public-Suggestions
  description: 'Microsoft Azure Microsoft Marketplace Search API — Public-Suggestions. 1 operations. Lead operation: Microsoft
    Azure Public Suggestions Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace Public Products Suggestions
    Per Requested Properties In Addition, It Enables Filtering On Selected Product properties, And Getting Product Details
    Each Api Request Must Include An Api Key A'
  tags:
  - Microsoft Azure
  - Public-Suggestions
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: microsoft-marketplace-search-public-suggestions
    baseUri: https://catalogapi.azure.com
    description: Microsoft Azure Microsoft Marketplace Search API — Public-Suggestions business capability. Self-contained,
      no shared references.
    resources:
    - name: suggestions-products
      path: /suggestions/products
      operations:
      - name: microsoftazuresuggestionsgetproducts
        method: GET
        description: Microsoft Azure Public Suggestions Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
          Public Products Suggestions Per Requested Properties In Addition, It Enables Filtering On Selected Product properties,
          And Getting
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: api-version
          in: query
          type: string
          description: Version of the REST API used for the request.
          required: true
        - name: searchQuery
          in: query
          type: string
          description: The search text, if no value provided, this filter is ignored. Such as searchQuery=red hat
          required: true
        - name: publisherDisplayName
          in: query
          type: string
          description: The search publisher name. Such as publisherDisplayName=red hat. If no value provided, this filter
            is ignored.
        - name: azureBenefit
          in: query
          type: string
          description: 'Define the search for only azure benefit eligible offers, if no value provided, this filter is ignored.
            Default: null. '
        - name: publisherTypes
          in: query
          type: array
          description: 'Products that contains any of the given publisher types, If no value provided, this filter is ignored.
            Possible values: Microsoft, ThirdParty. Default: Microsof'
        - name: badges
          in: query
          type: array
          description: 'Products that contains any of the given badges. If no value provided, this filter is ignored. The
            following product badges are available: '
        - name: industryCloud
          in: query
          type: string
          description: 'Define the search for IndustryCloud offers. If no value provided, this filter is ignored. Default:
            NotApplicable. '
        - name: language
          in: query
          type: string
          description: Language to search, ISO 639-1 two-letter code, possible values - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,zh-hans,zh-hant'
          required: true
        - name: productTypes
          in: query
          type: array
          description: Products that contains any of the given product types, Such as 'VirtualMachine'. If no value provided,
            this filter is ignored.
        - name: pricingTypes
          in: query
          type: array
          description: 'Products that contains any of the given pricing types. If no value provided, this filter is ignored. '
        - name: operatingSystems
          in: query
          type: array
          description: 'Products that contains any of the given operating systems, Such as operatingSystems=windows,linux.
            If no value provided, this filter is ignored. This filter is '
        - name: supportedProducts
          in: query
          type: array
          description: Products that contains any of the given supported products. Such as 'CRM'. If no value provided, this
            filter is ignored.
        - name: publisherIds
          in: query
          type: array
          description: Products that contains any of the given publisher ids. Such as 'Microsoft'. If no value provided, this
            filter is ignored.
        - name: ratingBuckets
          in: query
          type: array
          description: 'Products that contains any of the given rating buckets. Such as ''Above1''. If no value provided,
            this filter is ignored. '
        - name: vmArchitectureTypes
          in: query
          type: array
          description: Array of Virtual Machine image architecture types to search by, If no value provided, this filter is
            ignored. see https://docs.microsoft.com/en-us/azure/virtual
        - name: vmSecurityTypes
          in: query
          type: array
          description: 'Products that contains any of the given vm security types. Such as ''Trusted''. If no value provided,
            this filter is ignored. '
        - name: suggestionTypes
          in: query
          type: array
          description: 'Suggestion types. '
          required: true
        - name: top
          in: query
          type: integer
          description: 'Number of items per SuggestionType to return. Minimum: 1, Maximum: 40, Default: 20.'
        - name: select
          in: query
          type: array
          description: 'Array of fields to return. Such as ''displayText''. If no value provided, return fields as follows.
            if suggestionsType=Entity, return: suggestionType, displayText'
  exposes:
  - type: rest
    namespace: microsoft-marketplace-search-public-suggestions-rest
    port: 8080
    description: REST adapter for Microsoft Azure Microsoft Marketplace Search API — Public-Suggestions. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/suggestions/products
      name: suggestions-products
      description: REST surface for suggestions-products.
      operations:
      - method: GET
        name: microsoftazuresuggestionsgetproducts
        description: Microsoft Azure Public Suggestions Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
          Public Products Suggestions Per Requested Properties In Addition, It Enables Filtering On Selected Product properties,
          And Getting
        call: microsoft-marketplace-search-public-suggestions.microsoftazuresuggestionsgetproducts
        with:
          api-version: rest.api-version
          searchQuery: rest.searchQuery
          publisherDisplayName: rest.publisherDisplayName
          azureBenefit: rest.azureBenefit
          publisherTypes: rest.publisherTypes
          badges: rest.badges
          industryCloud: rest.industryCloud
          language: rest.language
          productTypes: rest.productTypes
          pricingTypes: rest.pricingTypes
          operatingSystems: rest.operatingSystems
          supportedProducts: rest.supportedProducts
          publisherIds: rest.publisherIds
          ratingBuckets: rest.ratingBuckets
          vmArchitectureTypes: rest.vmArchitectureTypes
          vmSecurityTypes: rest.vmSecurityTypes
          suggestionTypes: rest.suggestionTypes
          top: rest.top
          select: rest.select
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: microsoft-marketplace-search-public-suggestions-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Microsoft Marketplace Search API — Public-Suggestions. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-public-suggestions-api
      description: Microsoft Azure Public Suggestions Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
        Public Products Suggestions Per Requested Properties In Addition, It Enables Filtering On Selected Product properties,
        And Getting
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-marketplace-search-public-suggestions.microsoftazuresuggestionsgetproducts
      with:
        api-version: tools.api-version
        searchQuery: tools.searchQuery
        publisherDisplayName: tools.publisherDisplayName
        azureBenefit: tools.azureBenefit
        publisherTypes: tools.publisherTypes
        badges: tools.badges
        industryCloud: tools.industryCloud
        language: tools.language
        productTypes: tools.productTypes
        pricingTypes: tools.pricingTypes
        operatingSystems: tools.operatingSystems
        supportedProducts: tools.supportedProducts
        publisherIds: tools.publisherIds
        ratingBuckets: tools.ratingBuckets
        vmArchitectureTypes: tools.vmArchitectureTypes
        vmSecurityTypes: tools.vmSecurityTypes
        suggestionTypes: tools.suggestionTypes
        top: tools.top
        select: tools.select
      outputParameters:
      - type: object
        mapping: $.