GraphQL API
Queries
Making GraphQL queries and examples
Supported Operations
Currently, the GraphQL API supports full read operations for the Product Catalog.
Fetch Products (List)
Retrieve paginated lists of products with precise field selection.
query GetProducts {
products(limit: 10, offset: 0) {
products {
id
title
handle
thumbnail
status
# Fetch nested relationships efficiently
collection {
title
}
}
count
offset
limit
}
}Fetch Product Details
Get a single product with deep relationships. DataLoaders ensure this does not cause N+1 query performance issues.
query GetProductDetail($id: ID!) {
product(id: $id) {
id
title
description
handle
# Core dimensions
weight
length
width
height
# Relationships
collection {
id
title
}
tags {
id
value
}
images {
id
url
}
variants {
id
title
sku
# Calculated prices (dynamic field)
calculated_price {
calculated_amount
currency_code
}
}
options {
id
title
}
}
}Variables:
{
"id": "prod_01H..."
}