API Reference
Marketplace API
Public marketplace search/profile/product routes and developer-authenticated list/unlist controls.
SoundSync
Verified endpoints
These endpoints are route-backed in the current platform.
GET
/api/marketplace/products
Search public marketplace products.
- Auth
- Public read endpoint.
- Scope
- Listed and visible marketplace product scope.
- Request fields
- q/category/tag/type/status/minPrice/maxPrice/sort/page/limit query
- Returns
- products[], pagination/facets as returned by marketplace product service.
- Side effects
- None for read endpoints unless noted.
GET
/api/marketplace/products/:id
Fetch one public marketplace product.
- Auth
- Public read endpoint.
- Scope
- Developer-owned or public storefront/marketplace scope as noted.
- Request fields
- id path parameter
- Returns
- { product } or PRODUCT_NOT_FOUND.
- Side effects
- None for read endpoints unless noted.
GET
/api/marketplace/developers/:slug
Fetch public marketplace developer profile.
- Auth
- Public read endpoint.
- Scope
- Developer-owned or public storefront/marketplace scope as noted.
- Request fields
- developer slug
- Returns
- developer profile and public product context.
- Side effects
- None for read endpoints unless noted.
POST
/api/marketplace/products/:id/list
List developer-owned product in marketplace.
- Auth
- Developer JWT.
- Scope
- Developer-owned or public storefront/marketplace scope as noted.
- Request fields
- Developer JWT
- product id
- metadata optional
- Returns
- { product } listed state.
- Side effects
- Updates marketplace_status/visibility through marketplace product service.
POST
/api/marketplace/products/:id/unlist
Unlist developer-owned product from marketplace.
- Auth
- Developer JWT.
- Scope
- Developer-owned or public storefront/marketplace scope as noted.
- Request fields
- Developer JWT
- product id
- metadata optional
- Returns
- { product } unlisted state.
- Side effects
- Updates marketplace visibility.