# CacheBy Public Search API

Read-only catalog search. **No authentication.** Base URL: `https://api.cacheby.com`

Machine-readable spec: [https://cacheby.com/.well-known/openapi.json](https://cacheby.com/.well-known/openapi.json)

## Quickstart

```bash
curl "https://api.cacheby.com/search?q=DMSO&menu=products"
```

## Endpoints

| Method | Path | Purpose |
|---|---|---|
| GET | `/search` | Search by keyword, brand, part number, or CAS number |
| GET | `/search/auto-complete` | Autocomplete for a partial query |
| GET | `/search/similar` | Products similar to a given product id |
| GET | `/search/keywords/popular` | Popular search keywords |
| GET | `/search/keywords/related` | Keywords searched alongside a query |
| POST | `/chemical/multi-search` | Look up several CAS numbers at once |
| POST | `/chemical/substitutes` | Alternatives for the same CAS number |
| POST | `/chemical/batch-search` | Compare catalog prices for a list of reagents |

`GET /search` takes `q` (required), `menu=products` (required), `page` (24 per page)
and `sort`. It returns `{ hits: [...], estimatedTotalHits }`.

## Not available

Cart, ordering, quotes and payment are not part of this API. For those, use the site or talk to
us at info@cacheby.com.