# Search API

> Search API on Apizie: 3 endpoints (Get counts of Marketplace public products with requested properties., Serves a user experience with search and filter results on Marketplace public products., Make suggestions while user is typing a search query for products.) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:azure-marketplacecatalog-search/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-marketplacecatalog-search`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://apizie.tech/api/cloud/azure-marketplacecatalog-search
- OpenAPI: https://apizie.tech/api/cloud/azure-marketplacecatalog-search/openapi.json

Microsoft Marketplace Discovery APIs

## Endpoints

### Get counts of Marketplace public products with requested properties.
`GET https://apizie.tech/v1/cloud:azure-marketplacecatalog-search/facets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| facets | array | no | Array of facets to facet by, if none provided then no facets will return. Such as facets=PricingTypes,operatingSystems. -… |
| language | string | yes | 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' |
| market | string | yes | Product sold market, Possible values - https://docs.microsoft.com/en-us/azure/marketplace/marketplace-geo-availability-currencies or 'All'… |
| azureBenefit | string | no | Define the search for only azure benefit eligible offers, if no value provided, this filter is ignored. Default: null. - `Eligible`:… |
| badges | array | no | Products that contains any of the given badges. If no value provided, this filter is ignored. The following product badges are available:… |
| hideKeys | array | no | Products that contains any of the given hideKeys for preview. Such as '22c6b3ae-1111-1111-1111-e7cbdc8569dd'. If no value provided, this… |
| industryCloud | string | no | Define the search for IndustryCloud offers. If no value provided, this filter is ignored. Default: NotApplicable. - `NotApplicable`: Not… |
| operatingSystems | array | no | Products that contains any of the given operating systems, Such as operatingSystems=windows,linux. If no value provided, this filter is… |
| pricingTypes | array | no | Products that contains any of the given pricing types. If no value provided, this filter is ignored. - `Byol`: The product has at least… |
| productTypes | array | no | Products that contains any of the given product types, Such as 'VirtualMachine'. If no value provided, this filter is ignored. Possible… |
| publisherDisplayName | string | no | The search publisher name. Such as publisherDisplayName=red hat. If no value provided, this filter is ignored. |
| publisherIds | array | no | Products that contains any of the given publisher ids. Such as 'Microsoft'. If no value provided, this filter is ignored. |
| publisherTypes | array | no | Products that contains any of the given publisher types, If no value provided, this filter is ignored. Possible values: Microsoft,… |
| publishingStage | string | no | Audience. Default: Public. - `Preview`: Preview. - `Public`: Public |
| ratingBuckets | array | no | Products that contains any of the given rating buckets. Such as 'Above1'. If no value provided, this filter is ignored. - `AboveOne`:… |
| searchQuery | string | no | The search text, if no value provided, this filter is ignored. Such as searchQuery=red hat |
| supportedProducts | array | no | Products that contains any of the given supported products. Such as 'CRM'. If no value provided, this filter is ignored. |
| vmArchitectureTypes | array | no | Array of Virtual Machine image architecture types to search by, If no value provided, this filter is ignored. see… |
| vmSecurityTypes | array | no | Products that contains any of the given vm security types. Such as 'Trusted'. If no value provided, this filter is ignored. - `None`:… |

### Serves a user experience with search and filter results on Marketplace public products.
`GET https://apizie.tech/v1/cloud:azure-marketplacecatalog-search/search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| language | string | yes | 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' |
| market | string | yes | Product sold market, Possible values - https://docs.microsoft.com/en-us/azure/marketplace/marketplace-geo-availability-currencies or 'All'… |
| select | array | no | Array of fields to return. Such as select=pricingTypes. - `All`: All fields. - `SupportedProducts`: Supported Products. - `PublisherId`:… |
| azureBenefit | string | no | Define the search for only azure benefit eligible offers, if no value provided, this filter is ignored. Default: null. - `Eligible`:… |
| badges | array | no | Products that contains any of the given badges. If no value provided, this filter is ignored. The following product badges are available:… |
| facets | array | no | Array of facets to facet by, if none provided then no facets will return. Such as facets=PricingTypes,operatingSystems. -… |
| hideKeys | array | no | Products that contains any of the given hideKeys for preview. Such as '22c6b3ae-1111-1111-1111-e7cbdc8569dd'. If no value provided, this… |
| industryCloud | string | no | Define the search for IndustryCloud offers. If no value provided, this filter is ignored. Default: NotApplicable. - `NotApplicable`: Not… |
| operatingSystems | array | no | Products that contains any of the given operating systems, Such as operatingSystems=windows,linux. If no value provided, this filter is… |
| orderby | array | no | Array of sort by fields to order by and ordering type (asc\desc), If no value provided, ordered by search score. Default ordering type:… |
| pricingTypes | array | no | Products that contains any of the given pricing types. If no value provided, this filter is ignored. - `Byol`: The product has at least… |
| productTypes | array | no | Products that contains any of the given product types, Such as 'VirtualMachine'. If no value provided, this filter is ignored. Possible… |
| publisherDisplayName | string | no | The search publisher name. Such as publisherDisplayName=red hat. If no value provided, this filter is ignored. |
| publisherIds | array | no | Products that contains any of the given publisher ids. Such as 'Microsoft'. If no value provided, this filter is ignored. |
| publisherTypes | array | no | Products that contains any of the given publisher types, If no value provided, this filter is ignored. Possible values: Microsoft,… |
| publishingStage | string | no | Audience. Default: Public. - `Preview`: Preview. - `Public`: Public |
| ratingBuckets | array | no | Products that contains any of the given rating buckets. Such as 'Above1'. If no value provided, this filter is ignored. - `AboveOne`:… |
| searchQuery | string | no | The search text, if no value provided, this filter is ignored. Such as searchQuery=red hat |
| supportedProducts | array | no | Products that contains any of the given supported products. Such as 'CRM'. If no value provided, this filter is ignored. |
| top | integer | no | Number of items to return. Minimum: 0, Maximum: 1000, Default: 20. |
| vmArchitectureTypes | array | no | Array of Virtual Machine image architecture types to search by, If no value provided, this filter is ignored. see… |
| vmSecurityTypes | array | no | Products that contains any of the given vm security types. Such as 'Trusted'. If no value provided, this filter is ignored. - `None`:… |

### Make suggestions while user is typing a search query for products.
`GET https://apizie.tech/v1/cloud:azure-marketplacecatalog-search/suggestions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| language | string | yes | 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' |
| searchQuery | string | yes | The search text. If no value is provided, this filter is ignored (e.g., searchQuery=red hat). The query must be at least 2 characters… |
| suggestionTypes | array | yes | Suggestion types. - `WordSearch`: WordSearch. - `Entity`: Entity. |
| azureBenefit | string | no | Define the search for only azure benefit eligible offers, if no value provided, this filter is ignored. Default: null. - `Eligible`:… |
| badges | array | no | Products that contains any of the given badges. If no value provided, this filter is ignored. The following product badges are available:… |
| industryCloud | string | no | Define the search for IndustryCloud offers. If no value provided, this filter is ignored. Default: NotApplicable. - `NotApplicable`: Not… |
| operatingSystems | array | no | Products that contains any of the given operating systems, Such as operatingSystems=windows,linux. If no value provided, this filter is… |
| pricingTypes | array | no | Products that contains any of the given pricing types. If no value provided, this filter is ignored. - `Byol`: The product has at least… |
| productTypes | array | no | Products that contains any of the given product types, Such as 'VirtualMachine'. If no value provided, this filter is ignored. Possible… |
| publisherDisplayName | string | no | The search publisher name. Such as publisherDisplayName=red hat. If no value provided, this filter is ignored. |
| publisherIds | array | no | Products that contains any of the given publisher ids. Such as 'Microsoft'. If no value provided, this filter is ignored. |
| publisherTypes | array | no | Products that contains any of the given publisher types, If no value provided, this filter is ignored. Possible values: Microsoft,… |
| ratingBuckets | array | no | Products that contains any of the given rating buckets. Such as 'Above1'. If no value provided, this filter is ignored. - `AboveOne`:… |
| select | array | no | Array of fields to return. Such as 'displayText'. If no value provided, return fields as follows. if suggestionsType=Entity, return:… |
| supportedProducts | array | no | Products that contains any of the given supported products. Such as 'CRM'. If no value provided, this filter is ignored. |
| top | integer | no | Number of items to return. Minimum: 0, Maximum: 1000, Default: 20. |
| vmArchitectureTypes | array | no | Array of Virtual Machine image architecture types to search by, If no value provided, this filter is ignored. see… |
| vmSecurityTypes | array | no | Products that contains any of the given vm security types. Such as 'Trusted'. If no value provided, this filter is ignored. - `None`:… |

## Example
```
curl "https://apizie.tech/v1/cloud:azure-marketplacecatalog-search/facets" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Search API?
Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:azure-marketplacecatalog-search/facets with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Search API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Search itself also needs your own key from azure.com.

### Can AI agents use the Search API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-marketplacecatalog-search.

### What is the status of the Search API?
Needs your own provider key (bring your own key)