How to Use Catalog Search

A quick guide to searching products, using filters, and accessing developer tools.

1

Search for Products

Enter your search query in the search bar on the homepage. The Catalog API uses semantic search, so you can describe what you're looking for naturally.

Example queries:

  • “wireless noise-canceling headphones”
  • “sustainable yoga mat”
  • “gift for coffee lover”
  • “minimalist desk lamp”

Press Enter or click the search button to see results from across Shopify stores.

2

Apply Filters

After searching, you can narrow results using filters:

Price Range

Set minimum and/or maximum prices to filter products within your budget.

Categories

Filter by product category to focus on specific types of items.

Availability

Toggle to show only products that are currently available for sale.

Ships To

Filter products by shipping destination country.

Shop IDs

Search within specific stores by entering their shop IDs (comma-separated).

Filters update results automatically as you change them.

3

View Product Details

Click on any product card to open a detailed view. This shows:

  • Product images and description
  • Available variants with pricing
  • Shop information for each variant
  • Direct link to purchase on the merchant's store
4

Save and Share Searches

The action bar below the filters provides several options:

Share Search

Copies the current URL to your clipboard. The URL includes your search query and filters, so others see the same results.

Save Search

Saves the current search to your browser's local storage. Access saved searches from the dropdown to quickly run them again.

Clear Filters

Resets the search and all filters to start fresh.

5

Developer Preview Panel

Below the search results, you'll find the developer preview panel with two tabs:

curl Request

A ready-to-use curl command that reproduces your current search. Copy this to test the API from your terminal or integrate into your application.

JSON Response

The raw JSON response from the Catalog API. Use this to understand the data structure and plan your integration.

The developer preview is especially useful when building integrations or debugging API behavior.

Ready to Search?

Go to the search page and try it out. For technical details about the API, see our Catalog API documentation.