Skip to main content

facets

Creates, updates, deletes, gets or lists a facets resource.

Overview

Namefacets
TypeResource
Idaws.marketplace_discovery.facets

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
listing_facetsobjectA map of facet types to their corresponding facet values. Each facet value includes a display name, internal value, and count of matching listings.
next_tokenstringIf nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page. (pattern: <code>[a-zA-Z0-9+/=]+</code>)
total_resultsinteger (int64)The total number of listings matching the search criteria.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
search_facetsselectregionReturns 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.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)

SELECT examples

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.

SELECT
listing_facets,
next_token,
total_results
FROM aws.marketplace_discovery.facets
WHERE region = '{{ region }}' -- required
;