Storefront API

Product Catalog & Search API

Read-only API powering product search, filtering, and category browsing for the storefront.

Runtime

Next.js 14

Database

Neon PostgreSQL

Cache

Upstash Redis

Hosting

Vercel

API Routes

All routes are GET-only except cache invalidation.

GET
/api/search30s HTTP

Full-text product search with filters and pagination

/api/search?q=white+shaker&limit=12
GET
/api/search/filtersRedis 5min

Dynamic filter options with contextual counts

/api/search/filters?category_id=1796
GET
/api/search/suggest30s HTTP

Autocomplete suggestions (products, categories, SKUs)

/api/search/suggest?q=shaker
GET
/api/preview60s HTTP

Product quick-view with related product data

/api/preview?id=62143
GET
/api/productsRedis 5min

Raw paginated products by category

/api/products?category=1796&limit=12
GET
/api/filtersRedis 5min

Category products with dynamic filter options (composite)

/api/filters?category=1796&limit=12&Color=White
GET
/api/categories5min HTTP

All non-hidden categories with product counts

/api/categories
GET
/api/categories/[id]None

Legacy category products API

/api/categories/27263
GET
/api/categories/[id]/settingsRedis 10min

Category display configuration

/api/categories/27263/settings
POST
/api/cacheN/A

Invalidate all Redis cache keys

POST /api/cache
Storefront API · Read-only · Next.js 14Open Dashboard →