# Bele Marketplace (belezw.com) — Machine & LLM Interface

> Bele is a Zimbabwean marketplace platform connecting buyers directly with local sellers and physical storefronts via WhatsApp.

## Canonical Web Architecture
- **Homepage & Search**: https://belezw.com/
- **Storefronts Directory**: https://belezw.com/storefronts
- **About & Entity Overview**: https://belezw.com/about
- **Sitemap Index**: https://belezw.com/sitemap.xml

## Main Categories
- Clothes: https://belezw.com/category/clothes
- Shoes: https://belezw.com/category/shoes
- Bags: https://belezw.com/category/bags
- Accessories: https://belezw.com/category/accessories
- Electronics: https://belezw.com/category/electronics
- Grooming & Beauty: https://belezw.com/category/grooming-beauty
- Kids & Baby: https://belezw.com/category/kids-baby

## Main Locations
- Harare: https://belezw.com/location/harare
- Bulawayo: https://belezw.com/location/bulawayo

## Structured Data & Machine Formats
- All listing pages (https://belezw.com/listings/[id]) embed schema.org Product and Offer JSON-LD schema with exact prices (USD), condition, and seller details.
- All category and directory pages embed schema.org ItemList and BreadcrumbList JSON-LD schema.
- All storefront pages (https://belezw.com/[storeSlug]) embed schema.org LocalBusiness JSON-LD schema with physical shop addresses and geo coordinates.

## Public API Endpoints
- Public Listings Search: GET https://api.belezw.com/api/v1/listings/?page=1&page_size=100
- Public Listing Detail: GET https://api.belezw.com/api/v1/listings/[id]
- Public Storefronts: GET https://api.belezw.com/api/v1/seller/storefronts/popular?limit=50
- Public Categories: GET https://api.belezw.com/api/v1/categories/