Microsoft Azure Microsoft Marketplace Search API — Public-Search

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Microsoft Marketplace Search API — Public-Search
  description: 'Microsoft Azure Microsoft Marketplace Search API — Public-Search. 2 operations. Lead operation: Microsoft
    Azure Public Facets Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace Public Products Counts
    Per Requested Properties In Addition, It Enables Filtering On Selected Product properties, Search, And Getting Product
    Details Each Api Request Must Include An Api Key Allocate'
  tags:
  - Microsoft Azure
  - Public-Search
  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-search
    baseUri: https://catalogapi.azure.com
    description: Microsoft Azure Microsoft Marketplace Search API — Public-Search business capability. Self-contained, no
      shared references.
    resources:
    - name: facets
      path: /facets
      operations:
      - name: microsoftazurefacetsget
        method: GET
        description: Microsoft Azure Public Facets Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
          Public Products Counts Per Requested Properties In Addition, It Enables Filtering On Selected Product properties,
          Search, And Getting P
        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
        - 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: hideKeys
          in: query
          type: array
          description: Products that contains any of the given hideKeys for preview. Such as '22c6b3ae-1111-1111-1111-e7cbdc8569dd'.
            If no value provided, this filter is ignored. This
        - name: market
          in: query
          type: string
          description: Product sold market, Possible values - https://docs.microsoft.com/en-us/azure/marketplace/marketplace-geo-availability-currencies
            or 'All' for all markets. Such
          required: true
        - 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: publishingStage
          in: query
          type: string
          description: 'Audience. Default: Public.'
        - name: facets
          in: query
          type: array
          description: 'Array facets to facet by, if none provided then no facets will return. Such as facets=PricingTypes,operatingSystems. '
          required: true
    - name: search
      path: /search
      operations:
      - name: microsoftazuresearchget
        method: GET
        description: Microsoft Azure Public Search Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
          Public Products, Total Count Of Products Returned, And Facets Per Requested Properties In Addition, It Enables Filtering
          On Selected Pr
        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
        - 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: select
          in: query
          type: array
          description: 'Array of fields to return. Such as select=pricingTypes. '
          required: true
        - name: orderBy
          in: query
          type: array
          description: 'Array of sort by fields to order by and ordering type (asc\desc), If no value provided, ordered by
            search score. Default ordering type: asc. For example, orderb'
        - 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: hideKeys
          in: query
          type: array
          description: Products that contains any of the given hideKeys for preview. Such as '22c6b3ae-1111-1111-1111-e7cbdc8569dd'.
            If no value provided, this filter is ignored. This
        - name: market
          in: query
          type: string
          description: Product sold market, Possible values - https://docs.microsoft.com/en-us/azure/marketplace/marketplace-geo-availability-currencies
            or 'All' for all markets. Such
          required: true
        - 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: publishingStage
          in: query
          type: string
          description: 'Audience. Default: Public.'
        - name: facets
          in: query
          type: array
          description: 'Array facets to facet by, if none provided then no facets will return. Such as facets=PricingTypes,operatingSystems. '
        - name: skip
          in: query
          type: integer
          description: 'Number of items to skip. Minimum: 0, Maximum: 100000, Default : 0.'
        - name: top
          in: query
          type: integer
          description: 'Number of items to return. Minimum: 0, Maximum: 1000, Default: 20.'
  exposes:
  - type: rest
    namespace: microsoft-marketplace-search-public-search-rest
    port: 8080
    description: REST adapter for Microsoft Azure Microsoft Marketplace Search API — Public-Search. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/facets
      name: facets
      description: REST surface for facets.
      operations:
      - method: GET
        name: microsoftazurefacetsget
        description: Microsoft Azure Public Facets Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
          Public Products Counts Per Requested Properties In Addition, It Enables Filtering On Selected Product properties,
          Search, And Getting P
        call: microsoft-marketplace-search-public-search.microsoftazurefacetsget
        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
          hideKeys: rest.hideKeys
          market: rest.market
          supportedProducts: rest.supportedProducts
          publisherIds: rest.publisherIds
          ratingBuckets: rest.ratingBuckets
          vmArchitectureTypes: rest.vmArchitectureTypes
          vmSecurityTypes: rest.vmSecurityTypes
          publishingStage: rest.publishingStage
          facets: rest.facets
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/search
      name: search
      description: REST surface for search.
      operations:
      - method: GET
        name: microsoftazuresearchget
        description: Microsoft Azure Public Search Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
          Public Products, Total Count Of Products Returned, And Facets Per Requested Properties In Addition, It Enables Filtering
          On Selected Pr
        call: microsoft-marketplace-search-public-search.microsoftazuresearchget
        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
          select: rest.select
          orderBy: rest.orderBy
          productTypes: rest.productTypes
          pricingTypes: rest.pricingTypes
          operatingSystems: rest.operatingSystems
          hideKeys: rest.hideKeys
          market: rest.market
          supportedProducts: rest.supportedProducts
          publisherIds: rest.publisherIds
          ratingBuckets: rest.ratingBuckets
          vmArchitectureTypes: rest.vmArchitectureTypes
          vmSecurityTypes: rest.vmSecurityTypes
          publishingStage: rest.publishingStage
          facets: rest.facets
          skip: rest.skip
          top: rest.top
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: microsoft-marketplace-search-public-search-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Microsoft Marketplace Search API — Public-Search. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-public-facets-api
      description: Microsoft Azure Public Facets Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
        Public Products Counts Per Requested Properties In Addition, It Enables Filtering On Selected Product properties,
        Search, And Getting P
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-marketplace-search-public-search.microsoftazurefacetsget
      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
        hideKeys: tools.hideKeys
        market: tools.market
        supportedProducts: tools.supportedProducts
        publisherIds: tools.publisherIds
        ratingBuckets: tools.ratingBuckets
        vmArchitectureTypes: tools.vmArchitectureTypes
        vmSecurityTypes: tools.vmSecurityTypes
        publishingStage: tools.publishingStage
        facets: tools.facets
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-public-search-api
      description: Microsoft Azure Public Search Api Provides An Unauthenticated Endpoint For Consuming List Of Marketplace
        Public Products, Total Count Of Products Returned, And Facets Per Requested Properties In Addition, It Enables Filtering
        On Selected Pr
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-marketplace-search-public-search.microsoftazuresearchget
      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
        select: tools.select
        orderBy: tools.orderBy
        productTypes: tools.productTypes
        pricingTypes: tools.pricingTypes
        operatingSystems: tools.operatingSystems
        hideKeys: tools.hideKeys
        market: tools.market
        supportedProducts: tools.supportedProducts
        publisherIds: tools.publisherIds
        ratingBuckets: tools.ratingBuckets
        vmArchitectureTypes: tools.vmArchitectureTypes
        vmSecurityTypes: tools.vmSecurityTypes
        publishingStage: tools.publishingStage
        facets: tools.facets
        skip: tools.skip
        top: tools.top
      outputParameters:
      - type: object
        mapping: $.