# Chumbak Retail Tutorial

> Live product search from a real retail website

- Vendor: `chumbakretailtutorial` · version 1.0 · category E-commerce · tags retail, product search, tutorial
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/chumbakretailtutorial
- This document: https://apiclay.com/docs/chumbakretailtutorial.md
- OpenAPI 3.1: https://apiclay.com/api/chumbakretailtutorial/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `chumbakretailtutorial`
- Updated: 2026-11-18

## About

## Chumbak Retail Tutorial

Private educational demonstration of live product search in APIClay.

### Endpoint
POST /products/search

Example JSON body:
```json
{"query":"mugs"}
```

Returns up to ten products with identifiers, titles, prices, handles and product types.

Source: https://www.chumbak.com/pages/searchtap-search?q=mugs
Product information belongs to Chumbak. This tutorial is not affiliated with or endorsed by Chumbak. Data may change.

## Pricing

- Pay as you go: 0.0012 credits/request
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /products/search — Product search
- Gateway: `POST https://api.apiclay.com/v1/api/chumbakretailtutorial/products/search`
- Body sample (JSON):

```json
{
  "query": "mugs"
}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/chumbakretailtutorial/products/search" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "query": "mugs" }'
```

Index of every published API: https://apiclay.com/llms.txt
