Merchant products no longer appearing in Shopify Catalog API

Agentic Commerce
1

We are agency working with a French merchant on Shopify. As part of our agentic commerce exploration, we have been using the Catalog API and Catalog MCP to search and discover products from this merchant’s store.

The store is active, products are published, have taxonomy categories, stock, and are available for sale. The Storefront MCP and Storefront API work perfectly fine for this store.

What worked before

A few weeks ago, searching the Catalog API returned products from this merchant’s store correctly. We have saved responses showing valid results with proper shop data, variant details, checkout URLs, and UPIDs.

For example, a simple search query like below returned the merchant’s products with full variant and shop information.


GET /global/v2/search?query={keyword}&limit=10

What is happening now

The exact same queries now return empty results. We tested every available endpoint systematically.

Search endpoint

  • Searching with the merchant’s name returns zero results

  • Searching with shop_ids parameter using the merchant’s shop GID returns zero results

  • Searching with available_for_sale=0 still returns zero results

  • Generic queries (like “robe”, “sac”) return results from other stores but never from this merchant

Lookup by UPID

  • Using a UPID from a previous successful response now returns {"errors": {"product": ["Not found"]}}

  • Adding available_for_sale=0 does not change the result

Lookup by variant

  • Using a variant ID from a previous successful response also returns {"errors": {"product": ["Not found"]}}

Meanwhile

  • The Storefront MCP scoped to this merchant’s store works perfectly

  • The merchant’s products are active, in stock, and have taxonomy categories assigned

  • No changes were made to the merchant’s store configuration between the working and non-working periods

What we ruled out

  • Not a ships_to filter issue (tested with the merchant’s country and without)

  • Not an available_for_sale filter issue (tested with value set to 0)

  • Not a query issue (tested with product names, brand names, generic terms)

  • Not a Saved Catalog configuration issue (tested both with and without saved catalog)

  • Not a product-level issue (the entire shop is absent, not just individual products)

Environment

  • Merchant store located in France

  • Catalog API v2 endpoints

  • Authentication via Dev Dashboard API keys (JWT token)

  • Tested using both REST API and MCP server

Question

Is there a known eligibility mechanism or indexing process that could cause a previously indexed merchant to be removed from the global Catalog? We could not find documentation on merchant eligibility criteria or opt-in/opt-out processes.

We are happy to share merchant details, shop GID, and previous successful API responses privately if that helps investigate.

1 Like
2

Hey @blanklob :waving_hand: - there are a few requirements here for being listed on the Catalog API:

https://help.shopify.com/en/manual/promoting-marketing/seo/shopify-catalog/requirements

The main culprit I could see is if the shop is password protected or if they don’t ship to the US or Canada. If you don’t see any reason for why they should be excluded though, just ping me here with the myshopify URL and I can take a look for sure.

3

Hey we do ship to the US/FR and store is live never been closed or anything i already checked that list and verified all against it.

4

Thanks for confirming @blanklob -, in that case, that does sound weird. Could you share a myshopify.com URL for the shop with me? Let me know if you’d rather share that privately and I can open a DM with you.

1 Like
5

“To be automatically included in Shopify Catalog“ Is there another ways to be included in Shopify catalog? Can shops that do not ship to the USA or Canada be somehow included?