POST

Search Variants


Search product variants using free-text search with advanced query capabilities.

Use this endpoint for complex queries that include free-text search, aggregations, or when you need faceted search results. For simple filtering, use Query Variants instead.

Supports Wix Query Language (WQL) for structured filtering combined with free-text search.

Note: Non-visible variants, and variants related to non-visible products are filtered from results if you don't have permissions to read hidden products.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Stores - all permissions
Read Stores - all read permissions
Manage Orders
Manage Products
Read Products
Manage Restaurants - all permissions
Read v3 catalog
Manage v3 catalog
Manage Stores
Read products in v3 catalog
Product v3 read admin
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/stores/v3/products/search-variants

Errors

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

Did this help?