POST

Query Products


Alpha

This method is in Alpha and may change in the future.

Retrieves a list of products with filtering, sorting, and cursor-based pagination.

Provides real-time, strongly consistent results with filtering, sorting, and pagination.

Use Query Products when you need accurate, up-to-date data such as for operational tasks or inventory checks. For product discovery and browsing with full-text search capabilities, use Search Products instead.

PropertyFiltersSort
directCategories$matchItemsNone
allCategories$matchItemsNone
options$matchItemsNone
options.values$matchItemsNone
shippingDestinations$matchItemsNone
id$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
name$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
providerInfo.appId$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
providerInfo.productId$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
supplierInfo.id$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
supplierInfo.verified$eq, $ne, $exists, $in, $hasSomeNone
directCategories.id$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
allCategories.id$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
visible$eq, $ne, $exists, $in, $hasSomeNone
typesNone
brand$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
inventory.tier$eq, $ne, $exists, $in, $hasSomeNone
productOrigin$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteNone
wholesaleOptions.minimumOrderQuantity$eq, $ne, $exists, $in, $hasSome, $lt, $lte, $gt, $gteNone
printOnDemandOptions.printTechnologiesNone
createdDate$eq, $ne, $exists, $in, $hasSome, $lt, $lte, $gt, $gteSort: ASC, DESC
minimumPrice$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
directCategories.index$eq, $ne, $exists, $in, $hasSome, $lt, $lte, $gt, $gteSort: ASC, DESC
allCategories.index$eq, $ne, $exists, $in, $hasSome, $lt, $lte, $gt, $gteSort: ASC, DESC
supplierInfo.rating$eq, $ne, $exists, $in, $hasSome, $startsWith, $gt, $lt, $lte, $gteSort: ASC, DESC
Authentication

This method may require higher-level permissions than the caller has, based on their identity and roles and permissions. In these cases, you can ensure the method is called with the required level of authorization by using one of the following:

Permissions
Read Marketplace
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/suppliers-hub/v1/products/query

Errors

This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?