query

Query Crystallize product, content, and commerce data via GraphQL APIs.

4|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/CrystallizeAPI/ai --skill query-crystallizeapi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: query
Source: https://github.com/CrystallizeAPI/ai/tree/main/use-crystallize/skills/query
Command: npx skills add https://github.com/CrystallizeAPI/ai --skill query-crystallizeapi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Users need a reliable way to query Crystallize for product, content, customer, order, and cart information without guessing which API or GraphQL shape to use.

Core Features & Use Cases

  • Choose the right read API: Select Core for admin-grade data and complex order/customer queries, Discovery for storefront search, browse, filtering, and faceting, Catalogue for deterministic path-based reads, and Shop API for cart/order edge operations.
  • Write correct GraphQL queries for each scenario: Supports item reads with components, order/customer listing with filters, storefront search and faceted navigation via Discovery, deterministic catalogue reads by path, and cart/order queries using Shop API endpoints.
  • Plan for pagination and consistency: Guides use of cursor-based pagination for Discovery and deterministic reads via Catalogue when exact current state is required.

Quick Start

Use the query skill to fetch product data for a storefront by running a Discovery API browse or search GraphQL query for your tenant and return the results with pagination.

Frequently Asked Questions about query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Crystallize product and commerce data using GraphQL?

To query Crystallize commerce data with GraphQL, select the correct API endpoint based on your intent: Core for admin data, Discovery for search, Catalogue for path reads, or Shop for cart operations. Then generate the appropriate GraphQL queries.

What is the best way to search and filter storefront products in Crystallize?

The best way to search and filter storefront products in Crystallize is using the Discovery API, which supports storefront browsing, semantic search with filters, and faceted navigation using cursor-based pagination.

When do I use the Catalogue API versus the Core API for Crystallize items?

Use the Crystallize Catalogue API for deterministic path-based reads when you need the exact current state of an item, and use the Core API for admin-grade data and complex order or customer queries.

How do I handle pagination for Crystallize GraphQL API queries?

Handle Crystallize GraphQL API pagination by using cursor-based pagination, which is specifically required for traversing large result sets in the Discovery API during storefront search and browse operations.

Can I manage cart and order intents using Crystallize GraphQL APIs?

Yes, you can manage cart and order intents using the Crystallize Shop API, which is designed specifically for cart and order edge operations within your GraphQL commerce workflow.