---
title: "GET /facets"
method: GET
path: "/facets"
---

# GET /facets

`GET /facets`

Get counts of Marketplace public products with requested properties.

## Query parameters

- `api-version` string, required
- `facets` string[]
- `language` string, required
- `market` string, required
- `azureBenefit` 'Eligible' | 'NotEligible'
- `badges` string[]
- `hideKeys` string[]
- `industryCloud` 'NotApplicable' | 'True' | 'False'
- `operatingSystems` string[]
- `pricingTypes` string[]
- `productTypes` string[]
- `publisherDisplayName` string
- `publisherIds` string[]
- `publisherTypes` string[]
- `publishingStage` 'Preview' | 'Public'
- `ratingBuckets` string[]
- `searchQuery` string
- `supportedProducts` string[]
- `vmArchitectureTypes` string[]
- `vmSecurityTypes` string[]

## Response `200`

The request has succeeded.

- FacetsResponse — Facets response object
  - `value` object, required — The facet items results

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2022-08-17-preview) `56d04fbecb70` — 1 warning, 3 info
  - the optional response header `x-ms-error-code` removed for the status `default`
  - api operation id `Facets_Get` removed and replaced with `Facets`
  - api tag `Public-Search` removed
  - the `query` request parameter `facets` became optional
- **2022-09-12** (2022-08-17-preview) `460782dc79a3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/marketplacecatalog-search/changes/facets/get.md)

---

[API](https://skmtc.dev/azure/apis/marketplacecatalog-search.md) · [All operations](https://skmtc.dev/azure/apis/marketplacecatalog-search/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/marketplacecatalog-search/revisions/56d04fbecb70/schema)