Retrieve catalog data with GraphQL graphql-queries
Use GraphQL queries to retrieve product, price, and other catalog data from the Catalog Service data space and render Adobe Commerce storefront experiences faster than native product queries.
NOTE
For Commerce solutions that use Adobe Commerce Optimizer or the Adobe Commerce Optimizer Connector, use the Merchandising Services GraphQL API instead of the Catalog Service GraphQL API.
The Catalog Service provides the following queries:
Query
Description
Usage
Limits
categoriesReturns category data. If the
subtree input object is specified, the query returns details about subcategories.Useful for rendering storefront navigation and category pages. See example.
—
productsReturns details about the SKUs specified as input.
Used primarily to render content on product detail and product compare pages. See example.
100 SKUs per request
productSearchReturns a list of products that match the search criteria.
Useful for rendering search results and product list pages based on search input. See example.
100 SKUs per request
refineProductNarrows the results of the
products query for a complex product to return specific information about a product variant.Useful for rendering updated product detail pages when shoppers select a product option. See example.
100 SKUs per request
variantsReturns details about all variations of a product.
Useful for showing variant images on product detail or listing pages without submitting multiple API requests. See example.
100 SKUs per request
See Storefront Services GraphQL for more information about using these queries.
recommendation-more-help
commerce-help-catalog-service