marketplacediscovery/aws.sdk.kotlin.services.marketplacediscovery/searchFacets

searchFacets

inline suspend fun MarketplaceDiscoveryClient.searchFacets(crossinline block: SearchFacetsRequest.Builder.() -> Unit): SearchFacetsResponse

Returns available facet values for filtering listings, such as categories, pricing models, fulfillment option types, publishers, and customer ratings. Each facet value includes a count of matching listings.

Samples

import aws.sdk.kotlin.services.marketplacediscovery.model.SearchFacetType
import aws.sdk.kotlin.services.marketplacediscovery.model.SearchFilter
import aws.sdk.kotlin.services.marketplacediscovery.model.SearchFilterType

fun main() { 
   //sampleStart 
   // Retrieve available facet values for listings in the machine learning category
val resp = marketplaceDiscoveryClient.searchFacets {
    searchText = "analytics"
    filters = listOf<SearchFilter>(
        SearchFilter {
            filterType = SearchFilterType.fromValue("CATEGORY")
            filterValues = listOf<String>(
                "machine-learning"
            )
        }            
    )
    facetTypes = listOf<SearchFacetType>(
        SearchFacetType.fromValue("FULFILLMENT_OPTION_TYPE"),
        SearchFacetType.fromValue("PRICING_MODEL")
    )
} 
   //sampleEnd
}

import aws.sdk.kotlin.services.marketplacediscovery.model.SearchFacetType
import aws.sdk.kotlin.services.marketplacediscovery.model.SearchFilter
import aws.sdk.kotlin.services.marketplacediscovery.model.SearchFilterType

fun main() { 
   //sampleStart 
   // Retrieve facets for security listings with ratings between 3. 0 and 5. 0 stars
val resp = marketplaceDiscoveryClient.searchFacets {
    filters = listOf<SearchFilter>(
        SearchFilter {
            filterType = SearchFilterType.fromValue("CATEGORY")
            filterValues = listOf<String>(
                "security"
            )
        },
        SearchFilter {
            filterType = SearchFilterType.fromValue("MIN_AVERAGE_CUSTOMER_RATING")
            filterValues = listOf<String>(
                "3.0"
            )
        },
        SearchFilter {
            filterType = SearchFilterType.fromValue("MAX_AVERAGE_CUSTOMER_RATING")
            filterValues = listOf<String>(
                "5.0"
            )
        }            
    )
    facetTypes = listOf<SearchFacetType>(
        SearchFacetType.fromValue("PRICING_MODEL"),
        SearchFacetType.fromValue("AVERAGE_CUSTOMER_RATING")
    )
} 
   //sampleEnd
}