--- title: "GET /search" method: GET path: "/search" --- # GET /search `GET /search` Serves a user experience with search and filter results on Marketplace public products. ## Query parameters - `api-version` string, required - `language` string, required - `market` string, required - `select` string[] - `azureBenefit` 'Eligible' | 'NotEligible' - `badges` string[] - `facets` string[] - `hideKeys` string[] - `industryCloud` 'NotApplicable' | 'True' | 'False' - `operatingSystems` string[] - `orderby` string[] - `pricingTypes` string[] - `productTypes` string[] - `publisherDisplayName` string - `publisherIds` string[] - `publisherTypes` string[] - `publishingStage` 'Preview' | 'Public' - `ratingBuckets` string[] - `searchQuery` string - `supportedProducts` string[] - `top` integer - `vmArchitectureTypes` string[] - `vmSecurityTypes` string[] ## Response `200` The request has succeeded. - SearchResponse — Search response object - `facets` object — The search facets - `results` ProductSummary[], required — The search results - `displayName` string — Product display name - `publisherId` string — Publisher id - `azureBenefit` 'Eligible' | 'NotEligible' — Azure benefit eligibility filter - `badges` string[] — Displays certification and qualification badges earned by the product for marketplace visibility - `publisherType` string — Identifies the publisher relationship to Microsoft for support and partnership classification. - `Microsoft` - First-party Microsoft product with direct Microsoft support and development - `ThirdParty` - Independent software vendor product with publisher-provided support and maintenance - `publishingStage` string — Indicates the product availability status and customer access level within Azure Marketplace. - `Preview` - Limited availability to selected customers for testing and early access evaluation - `Public` - General availability to all Azure Marketplace customers for production deployment - `uniqueProductId` string, required — Unique product identifier - `productType` string, required — Specifies the primary deployment model and hosting architecture for the marketplace product stored in the Marketplace Catalog. Possible values include, but are not limited to: - `None` - Unspecified product type, typically used for products without a defined deployment model - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels - `productSubType` string — Product sub type - `productFamily` string — Product Family - `operatingSystems` string[] — Operating system info for this product - `pricingTypes` string[] — Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing - `publisherDisplayName` string — Publisher display name - `longSummary` string — Product long summary - `summary` string — Product summary - `linkedAddInsTypes` object — Linked add-in types - `smallIconUri` string — URI to the small product icon - `description` string — The product description text - `cspLegalTermsUri` string — The legal terms of the product for the CSP - `privacyPolicyUri` string — The privacy policy of the product - `ratingBuckets` string[] — Categorizes products by customer rating thresholds for marketplace filtering and discovery. - `AboveOne` - Products with customer ratings exceeding 1.0 stars based on marketplace reviews - `AboveTwo` - Products with customer ratings exceeding 2.0 stars based on marketplace reviews - `AboveThree` - Products with customer ratings exceeding 3.0 stars based on marketplace reviews - `AboveFour` - Products with customer ratings exceeding 4.0 stars based on marketplace reviews - `ratingAverage` number, double — Average rating for the offer - `ratingCount` integer — Total number of ratings for the offer - `startingPrice` MarketStartPrice — Retail price of the product's cheapest plan - `market` string — The market for which the starting price is calculated - `termUnits` string — The terms pricing model units - `meterUnits` string — The meters pricing model units - `minTermPrice` number, float — Starting (minimal) terms price - `minMeterPrice` number, float — Starting (minimal) meters price - `currency` string — Currency for price - `plans` PlanSummary[] — Full set of plan/SKU attributes - `planId` string — Plan identifier - `uniquePlanId` string — Unique plan Id which is prefixed by combining uniqueProductId and PlanId with no separator in between - `displayName` string — Display name of the plan / sku - `vmArchitectureType` string — Specifies the virtual machine processor architecture and generation. Applies exclusively to Virtual Machine product types. - `X64Gen1` - x64 processor architecture with Generation 1 virtual machine firmware and BIOS support - `X64Gen2` - x64 processor architecture with Generation 2 virtual machine firmware and UEFI support - `Arm64` - ARM 64-bit processor architecture optimized for energy efficiency and cloud-native workloads - `cspState` string — Controls plan availability and partner access within the Microsoft Cloud Solution Provider (CSP) program. - `OptIn` - Enables all authorized Cloud Solution Provider partners to resell and deploy the product to customers - `OptOut` - Excluded from Cloud Solution Provider program, available only through direct channels - `SelectiveOptIn` - Available only to selected Cloud Solution Provider partners for resale and customer deployment - `metadata` PlanMetadata — Additional metadata - `generation` string — The VM image generation (applicable to Virtual Machine products only) - `altStackReference` string — Pointing to a planId which holds the alternative stack reference - `relatedSkus` PlanSkuRelation[] — Other plans that may be related to this plan - `sku` RelatedSku — Sku object related to given plan - `name` string — The Sku name - `generation` string — The Sku generation - `identity` string — The Sku identity - `relationType` string — Relation Type - `altStackReference` string — Alternative stack reference - `stackType` string — Stack type : Classic, Gen1, Gen2 - `altArchitectureReference` string — The alternative architecture reference - `categoryIds` string[] — Plan CategoryIds - `hasProtectedArtifacts` boolean — Set to true if plan has artifacts that are to be hidden for non authenticated users - `pricingTypes` string[] — Indicates the billing models and cost structures available for the plan. - `Free` - No charge for plan usage, typically for community editions or basic service tiers - `FreeTrial` - Time-limited free access period before transitioning to paid billing model - `Byol` - Bring Your Own License model where customers provide existing software licenses - `Payg` - Pay As You Go consumption-based billing calculated on actual resource usage - `Ri` - Reserved Instance billing with upfront commitment for discounted long-term pricing - `vmSecuritytypes` string[] — Defines the security enhancement level for virtual machine deployments. Applies exclusively to Virtual Machine product types. - `None` - Standard virtual machine security without additional protection features - `Trusted` - Trusted Launch security with secure boot and virtual Trusted Platform Module capabilities - `Confidential` - Confidential computing with memory encryption and attestation for sensitive workloads - `summary` string — The plan summary text - `description` string — Plan / sku description - `skuId` string — The SKU id - `planType` string, required — Specifies the primary deployment model and hosting architecture for the marketplace product. Currently supported values are: - `None` - Unspecified product type, typically used for products without a defined deployment model - `DevService` - Development-focused services and tools for software creation workflows - `ManagedApplication` - Azure Managed Applications that deploy and manage resources in customer subscriptions - `VirtualMachine` - Pre-configured virtual machine images deployable to Azure compute infrastructure - `AzureApplication` - Native Azure applications leveraging platform services and APIs - `Container` - Containerized applications deployed through Azure Container Instances or similar services - `SaaS` - Software as a Service solutions hosted and managed by the publisher - `SolutionTemplate` - Azure Resource Manager templates that provision multiple Azure resources - `IotEdgeModules` - Modules designed for deployment to Azure IoT Edge runtime environments - `ManagedServices` - Fully managed services where the publisher handles infrastructure and operations - `ContainerApps` - Applications built for Azure Container Apps serverless container platform - `VisualStudioExtension` - Extensions that integrate with Visual Studio IDE functionality - `DynamicsOps` - Microsoft Dynamics 365 Finance and Operations applications and extensions - `DynamicsCE` - Microsoft Dynamics 365 Customer Engagement applications and customizations - `DynamicsBC` - Microsoft Dynamics 365 Business Central applications and add-ons - `PowerBI` - Microsoft Power BI reports, dashboards, and data visualization components - `ConsultingServices` - Professional services offerings including implementation and advisory services - `CosellOnly` - Products available exclusively through Microsoft co-sell partner programs - `CoreVirtualMachine` - Core virtual machine offerings with baseline Azure compute capabilities - `PowerBIVisuals` - Custom visualizations for Microsoft Power BI reporting platform - `Office365` - Microsoft 365 and Office 365 applications, add-ins, and integrations - `AADApps` - Azure Active Directory integrated applications supporting organizational identity - `AzureServices` - Native Azure platform services and resource providers - `AppService` - Web applications hosted on Azure App Service platform - `LogAnalytics` - Azure Monitor Log Analytics solutions and workspace configurations - `MicrosoftProduct` - First-party Microsoft products available through marketplace channels - `displayRank` string — The order the plan is displayed in the 'Plans' table. Note that lower numbers appear first. - `isPrivate` boolean — Indication that the plan is accessible to restricted audience only - `hasRi` boolean — Indication whether the SKU supports reservations - `supportedProducts` string[] — Maps to the list of compatible products - `applicableProducts` string[] — Product categories the offer belongs to - `lastModifiedDateTime` string — Latest update date of the product - `locations` string[] — List of locations which are available on the SKUs - `serviceFamily` string — The service family of the product, such as 'Compute' - `service` string — The service name of the product, such as 'Virtual Machines' - `productId` string — A unique commercial identifier used to reference a specific product in transactional operations such as purchases, invoicing, and metering. This Id services entitlement validation, and billing across systems - `hasRiPlans` boolean — Indication whether the product has plans with reservations - `hasMarketplaceFootprint` boolean — Indication of whether product appears in Azure Marketplace - `attributes` Attribute[] — Set of products attributes - `key` string — The attribute key - `value` string — The attribute value - `activeDirectoryAppId` string — Used to map SaaS apps to their Azure AD appIds - `totalCount` integer — The total count of search results - `showingResultsFor` string — The search query used - `nextLink` string — The next link for pagination, if available ## Other responses - `default` — An unexpected error response. --- [API](https://skmtc.net/azure/apis/marketplacecatalog-search.md) · [All operations](https://skmtc.net/azure/apis/marketplacecatalog-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/marketplacecatalog-search/versions/56d04fbecb70/schema)