# Shoppi

> Shoppi (shoppi.app) is a shopping marketplace where consumers discover products and local businesses, and merchants sell online with Stripe-powered checkout. AI agents can search the catalog via JSON APIs and complete purchases through the Universal Commerce Protocol (UCP).

Shoppi is operated by Shoppi Inc. The merchant/SaaS side lives at https://shoppi.cloud, point-of-sale at https://pos.shoppi.app, payments at https://shoppi.pay.

## Agentic commerce (UCP)

- [UCP business profile](https://shoppi.app/.well-known/ucp): Universal Commerce Protocol discovery profile (spec 2026-04-08)
- [UCP REST endpoint](https://shoppi.app/ucp/v1): service descriptor; checkout sessions at POST /ucp/v1/checkout-sessions. No API payment handlers yet — buyers complete payment via the session continue_url (Stripe-hosted checkout).

## Product discovery APIs (JSON, no auth)

- [Search products](https://shoppi.app/api/search/results/json?query=sneakers&limit=20): full-text catalog search. Params: query, country, type, limit (max 50), skip, min_price, max_price, macro_category, sort, lat/long, city
- [Search suggestions](https://shoppi.app/api/search/suggestions/json?query=sn): typeahead suggestions
- [Categories](https://shoppi.app/api/search/getCategories/json): catalog category tree
- [Resolve item](https://shoppi.app/api_resolve.php?slug=item-slug): resolve a product/merchant slug to title, price, image, merchant
- [Local cities](https://shoppi.app/api/local/cities/json): cities with local businesses
- [Local businesses](https://shoppi.app/api/local/businesses/json?city=austin): local business directory

## Key pages

- [Homepage](https://shoppi.app/)
- [Search](https://shoppi.app/search.html): product search UI
- [Sell on Shoppi](https://shoppi.cloud/): merchant signup (free Basic Listing: 5 products/month)
- [Sitemap](https://shoppi.app/sitemap.xml)

## Notes for AI agents

- Product pages include schema.org Product/Offer markup (JSON-LD + microdata); prices are per-item in the listed currency.
- Item ids for UCP checkout line_items are the numeric `id` (or `clear_title` slug) returned by the search API.
- Checkout is Stripe-hosted; Shoppi merchants are the merchant of record.
- Contact: support@shoppi.app