Marketplace
The Marketplace resource (client.marketplace) lets you browse, publish, rate, and manage marketplace listings programmatically.
Methods
list(space_slug, *, search=, category=, sort=, page=, size=)
List marketplace listings with optional filtering and sorting.
| Parameter | Type | Default | Description |
|---|---|---|---|
space_slug | str | required | Space identifier |
search | str | None | None | Search string |
category | str | None | None | Category filter |
sort | str | "trending" | Sort: trending, newest, top_rated |
Returns: list[MarketplaceListing]
listings = await client.marketplace.list("analytics", sort="top_rated")
get(space_slug, listing_id)
Get a marketplace listing by ID.
Returns: MarketplaceListing
listing = await client.marketplace.get("analytics", listing_id)
publish(space_slug, product_id, *, category=)
Publish a data product to the marketplace. Fails with ValidationError if quality gates are not met.
| Parameter | Type | Default | Description |
|---|---|---|---|
space_slug | str | required | Space identifier |
product_id | UUID | required | Product to publish |
category | str | None | None | Marketplace category |
Returns: MarketplaceListing
listing = await client.marketplace.publish(
"analytics",
product_id,
category="Marketing",
)
unpublish(space_slug, listing_id)
Remove a listing from the marketplace (soft-archive).
Returns: None
await client.marketplace.unpublish("analytics", listing_id)
rate(space_slug, listing_id, *, rating, review=)
Rate a marketplace listing. Upserts if the user has already rated.
| Parameter | Type | Default | Description |
|---|---|---|---|
rating | int | required | 1–5 star rating |
review | str | None | None | Optional text review |
Returns: MarketplaceRating
rating = await client.marketplace.rate(
"analytics",
listing_id,
rating=5,
review="Excellent dataset with clear documentation",
)
get_reviews(space_slug, listing_id)
Get all reviews for a listing.
Returns: list[MarketplaceRating]
my_listings(space_slug)
Get the current user's published listings.
Returns: list[MarketplaceListing]
featured(space_slug)
Get featured and trending listings.
Returns: list[MarketplaceListing]