> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Query Products (Catalog V1)

## Article: Query Products (Catalog V1)

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/stores/skills/query-products-catalog-v1.md

## Article Content:

# RECIPE: Business Recipe - Query Products (Catalog V1)

## STEP 1: Query Products

Use `POST https://www.wixapis.com/stores-reader/v1/products/query` to query products from a V1 store.

**Basic query (all products):**

```bash
curl -X POST 'https://www.wixapis.com/stores-reader/v1/products/query' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
-d '{
  "query": {}
}'
```

---

## STEP 2: Filtering and Sorting

> **CRITICAL:** In V1, `filter` and `sort` are **JSON-encoded strings**, not objects — unlike V3 where they are plain objects.

**Query with filter and sort:**

```bash
curl -X POST 'https://www.wixapis.com/stores-reader/v1/products/query' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
-d '{
  "query": {
    "filter": "{\"visible\": true}",
    "sort": "[{\"fieldName\": \"name\", \"order\": \"ASC\"}]",
    "paging": {
      "limit": 50,
      "offset": 0
    }
  }
}'
```

**Query by product IDs:**

```bash
curl -X POST 'https://www.wixapis.com/stores-reader/v1/products/query' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH>' \
-d '{
  "query": {
    "filter": "{\"id\": {\"$in\": [\"product-id-1\", \"product-id-2\"]}}"
  }
}'
```

---

## Key Differences from V3

| Feature | Catalog V1 | Catalog V3 |
|---|---|---|
| Query endpoint | `POST /stores-reader/v1/products/query` | `POST /stores/v3/products/query` |
| Filter/sort | JSON-encoded strings | Plain objects |
| Additional fields | Not applicable | Enum values like `DESCRIPTION`, `URL` |

---

## Important Notes

- **Never use `/stores/v3/` endpoints on a CATALOG_V1 site** — they return `428 Precondition Required`.
- Check the site's catalog version in dynamic context before choosing endpoints.
- To create products on a V1 site, see [Create Product (Catalog V1)](https://dev.wix.com/docs/api-reference/business-solutions/stores/skills/create-product-catalog-v1.md).

## References

- [V1 Query Products](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v1/catalog/query-products.md)
- [Catalog Versioning Overview](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-versioning/introduction.md)