Frequently Asked Questions

Common questions about Catalog Search, the Catalog API, and how to use this tool.

Is this tool free?

Yes, Catalog Search is completely free to use. It's an open tool built by The Pages Media for the Shopify developer community. There are no usage limits for exploring the interface, though the underlying Catalog API has its own rate limits for high-volume programmatic access.

What data does the Catalog API return?

Global Catalog MCP returns products with options, rating, metadata (including inferred attributes when present), optional storefront-sourced categories, typed media with sources, variants with seller, url, checkout_url, price and list_price, plus pagination and messages. The API does not return customer data, order history, or inventory levels beyond basic availability status.

How is this different from Shopify Admin search?

The Shopify Admin search lets you search within your own store's products. Catalog Search queries across Shopify stores and products that meet Shopify Catalog requirements. It's designed for product discovery across stores, not managing your own inventory.

Why do some searches return unexpected results?

The Catalog API uses semantic search, which matches intent rather than exact keywords. This means a search for "warm winter jacket" might return insulated coats even if those words aren't in the title. Results also depend on which stores and products meet Shopify Catalog requirements and how well their product data is structured.

Can I use this for my own integration?

The JSON responses shown in the developer preview panel can help you build your own integrations. Example curl commands are available in the API documentation. However, production applications should reference the official Shopify Catalog API documentation for authentication requirements and best practices.

Why don't I see products from a specific store?

Products appear in Shopify Catalog when the store and product meet Shopify's requirements: Starter plan or higher, a published product with a title, image, positive price and identifiable URL, and an allowed category. Review eligibility and reasons in Sales channels > Agentic > Sources > Shopify Catalog, and data sharing in Catalog Mapping.

Learn more →

Can I purchase products directly through this tool?

Catalog Search links out to the merchant using the URL exactly as Shopify returns it. Shopify also offers Cart MCP, Checkout MCP, Order MCP and Shop MCP for agent shopping and Shop Pay checkout; those flows are not built into this tool.

How often is product data updated?

Product data in the Catalog API stays synchronized with merchant catalogs. When merchants update prices, availability, or product details in Shopify, those changes are reflected in API responses. The data is not a stale snapshot.

What is Universal Commerce Protocol?

UCP is an open protocol co-developed by Shopify, Google, Stripe and others, published at ucp.dev under Apache 2.0. Shopify's Catalog, Cart, Checkout and Order MCPs implement it.

Learn more →

Who built this?

Catalog Search is built by The Pages Media, a Shopify-focused development agency. We created it as a free tool for developers exploring the Catalog API and UCP ecosystem.

Learn more →

Does Catalog Search earn commission?

Only if enrolled in Promoted Placements beta, with accepted terms and Earn commission enabled for a saved catalog. A disclosure appears above results when active, and promoted offers are labelled. Links are never rewritten or routed through our domain.

What is Shop MCP and how is it different?

Shop MCP at https://mcp.shop.com offers catalog discovery, cart, Shop Pay checkout and order tools for agents; search needs no API key. Catalog Search uses Global Catalog MCP with our own credentials and links to the merchant exactly as Shopify returns the URL. Shop MCP checkout is not built into this tool.

Have Another Question?

Check our documentation for technical details, or contact The Pages Media for other inquiries.