Combined Listings via the Storefront API

Combined Listings via the Storefront API

matt-at-tapcart
Shopify Partner
1 0 1

We have multiple merchants with mobile apps who use the Combined Listings app. All of the product/collection data in our apps comes from the Storefront API. Therefore, we're currently looking into whether or not it's possible to retrieve Combined Listing data using the Storefront API.

 

I see this developer blog post from October 1, 2024 saying that Combined Listings is supported with the Storefront API, but it's quite vague:
https://shopify.dev/changelog/storefront-api-support-for-combined-listings

 

There seems to be a CombinedListing object exposed by the Admin GraphQL API:
https://shopify.dev/docs/api/admin-graphql/latest/objects/CombinedListing

 

However I'm not finding anything of the sort in the Storefront API documentation:
https://shopify.dev/docs/api/storefront/latest/objects/Product

 

I'm also not seeing any mention of Combined Listings in the Storefronts documentation:
https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections

 

Please advise us:
1. Whether or not it's possible to retrieve Combined Listings information from the Storefront API.
2. If #1 is true, how to retrieve Combined Listings information from the Storefront API.

 

Thank you in advance!
- Matt

 

Replies 3 (3)

Fabien_Sebban
Shopify Partner
52 0 20

Hi @matt-at-tapcart ,

Did you get the answer to your questions?

Thanks

srccb
Visitor
1 0 0

Hey @matt-at-tapcart@Fabien_Sebban 

I've got that to work lately. 

It works like a standard product and you can fetch the combined products via variants. The reason I couldn't get it to work in first place, I had to explicitly activate the combined listing product in the headless sales channel. 

See below the query that worked for me to fetch the combined listing as soon as it was activated.

query getProduct {
  product(handle: "xyz") {
    handle
    variants(first: 30) {
      nodes {
        availableForSale
        sku
      }
    }
  }
}

 

Fabien_Sebban
Shopify Partner
52 0 20

Thanks @srccb for your reply.

I had a weird problem with my app. When the Storefront API access request was enabled on the Partners dashboard, I had no access to combined listing products:

Capture d’écran 2025-05-23 à 18.05.58.png

 

Once I disabled it, I could access every product from the store, including the combined listing one, and the sales channel disappeared from the products' publishable sales channel menu.