Search Products

GET

{store_url}/api/v1//products/search

Searches for products using a free-text query with support for pagination, sorting, and advanced filters such as category, price range, sale status, and attribute values.

This endpoint is optimized for search-driven experiences (e.g., global search, autocomplete results, filtered search pages).

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠422Validation Error

🟠401Unauthorized

🔴500Internal Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request GET '{store_url}/api/v1//products/search' \
--header 'Content-Type: application/json' \
--data '{
    "page": 1,
    "page_size": 24,
    "q": "running shoes",
    "sort_by": "popularity_order",
    "order": "asc",
    "categories": "sports",
    "price_min": 100,
    "price_max": 500,
    "on_sale": true,
    "attribute_values": [
        "black",
        "size-42"
    ]
}'

Response Example

200 - Example 1

"Success"

Modified at 2026-02-17 07:22:33

List Products

Calculate Product Options Price